> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Prediction Markets

> Get started with the beta Kalshi and Polymarket API — auth, exchanges, market IDs, historical trades and candlesticks, and wallet analytics.

<Note>
  **Public Beta** — Unified Kalshi + Polymarket market data with full history. Join [Discord](https://discord.gg/JH2e9rR9fc) for support.
</Note>

<Info>
  **Base URL:** `https://prediction-market-api.solanatracker.io`\
  **Auth:** `x-api-key: YOUR_API_KEY` (same Data API key)\
  **Realtime:** [Datastream prediction rooms](/guides/datastream-prediction-markets)
</Info>

## First request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://prediction-market-api.solanatracker.io/v1/markets/trending?limit=5" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://prediction-market-api.solanatracker.io/v1/markets/trending?limit=5",
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  );
  const data = await res.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://prediction-market-api.solanatracker.io/v1/markets/trending",
      params={"limit": 5},
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  print(res.json())
  ```
</CodeGroup>

***

## Exchanges

Pass `exchange` (or aliases like `poly` for Polymarket) on most list endpoints:

| Value                 | Platform               |
| --------------------- | ---------------------- |
| `kalshi`              | Kalshi                 |
| `polymarket` / `poly` | Polymarket             |
| omit                  | Both (where supported) |

***

## Discover markets

| Endpoint                                         | Use for                             |
| ------------------------------------------------ | ----------------------------------- |
| `GET /v1/markets/trending`                       | Hot markets                         |
| `GET /v1/markets/new`                            | Recently listed                     |
| `GET /v1/markets/search`                         | Text by text                        |
| `GET /v1/browse`                                 | Browse / filter                     |
| `GET /v1/events`                                 | Event groupings with nested markets |
| `GET /v1/categories`, `/v1/series`, `/v1/sports` | Taxonomy                            |

```bash theme={null}
curl "https://prediction-market-api.solanatracker.io/v1/markets/search?q=bitcoin&exchange=polymarket" \
  -H "x-api-key: YOUR_API_KEY"
```

Fetch one market by ticker / condition id or by slug:

```bash theme={null}
curl "https://prediction-market-api.solanatracker.io/v1/markets/{ticker}" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://prediction-market-api.solanatracker.io/v1/markets/slug/{slug}" \
  -H "x-api-key: YOUR_API_KEY"
```

***

## Historical data

Full historical coverage for trades and candlesticks:

| Endpoint                                 | Returns                   |
| ---------------------------------------- | ------------------------- |
| `GET /v1/markets/{ticker}/trades`        | Trade tape for one market |
| `GET /v1/markets/trades`                 | Cross-market trades       |
| `GET /v1/markets/{ticker}/candlesticks`  | OHLCV for one market      |
| `GET /v1/events/{event_id}/candlesticks` | Event-level candles       |
| `GET /v1/markets/candlesticks/batch`     | Batch candles             |

```bash theme={null}
curl "https://prediction-market-api.solanatracker.io/v1/markets/{ticker}/candlesticks?interval=1h" \
  -H "x-api-key: YOUR_API_KEY"
```

***

## Live market state (REST)

| Endpoint                             | Returns                |
| ------------------------------------ | ---------------------- |
| `GET /v1/markets/{ticker}/price`     | Latest price           |
| `GET /v1/markets/{ticker}/midpoint`  | Mid                    |
| `GET /v1/markets/{ticker}/spread`    | Spread                 |
| `GET /v1/markets/{ticker}/orderbook` | Full book              |
| `GET /v1/markets/{ticker}/quote`     | Size-aware VWAP ladder |
| `GET /v1/markets/books`              | Batch books            |

For continuous updates, subscribe on Datastream instead of polling — see the [realtime guide](/guides/datastream-prediction-markets).

***

## Crypto up/down (Polymarket)

| Endpoint                           | Returns                            |
| ---------------------------------- | ---------------------------------- |
| `GET /v1/crypto/events`            | Active / recent crypto windows     |
| `GET /v1/crypto/price`             | Live underlying                    |
| `GET /v1/crypto/price-history`     | Historical underlying              |
| `GET /v1/events/{event_id}/crypto` | Price-to-beat / final for a window |
| `GET /v1/crypto/traders`           | Window traders                     |

Underlying Chainlink ticks also stream on `pm:crypto:{asset}` rooms. Outcome chance uses market price rooms (`pm:market:polymarket:{tokenId}:prices`).

***

## Wallet analytics (Polymarket)

Kalshi has no public wallets. Polymarket account endpoints use an Ethereum address:

| Endpoint                                      | Returns           |
| --------------------------------------------- | ----------------- |
| `GET /v1/accounts/{address}/overview`         | Summary           |
| `GET /v1/accounts/{address}/positions`        | Open positions    |
| `GET /v1/accounts/{address}/closed-positions` | Closed / resolved |
| `GET /v1/accounts/{address}/pnl`              | FIFO PnL          |
| `GET /v1/accounts/{address}/pnl/chart`        | PnL chart         |
| `GET /v1/accounts/{address}/trades`           | Fills             |
| `GET /v1/accounts/{address}/activity`         | Ledger activity   |

Leaderboards: `GET /v1/leaderboard/pnl`, `GET /v1/leaderboard/traders`, plus event-scoped variants under `/v1/events/{event_id}/...`.

***

## Batch helpers

| Endpoint                             | Notes                    |
| ------------------------------------ | ------------------------ |
| `GET` / `POST /v1/markets/batch`     | Many markets in one call |
| `GET /v1/events/batch`               | Many events              |
| `GET /v1/markets/candlesticks/batch` | Many candle series       |
| `GET /v1/markets/books`              | Many orderbooks          |

***

## Next steps

<CardGroup cols={2}>
  <Card title="Product overview" href="/prediction-markets/overview">
    Scope, IDs, and conventions.
  </Card>

  <Card title="Datastream guide" href="/guides/datastream-prediction-markets">
    Live trades, prices, books, and volume rooms.
  </Card>
</CardGroup>