Polymarket

Polymarket historical market data details - prediction market assets, data coverage and data collection specifics

Polymarket historical data is available since 2026-05-25.

Downloadable CSV files

Historical CSV datasets for the first day of each month are available to download without API key. See downloadable CSV files documentation.

Polymarket CSV exports use CLOB token IDs as per-symbol file names. The grouped daily trades file uses the PREDICTIONS symbol.

data type

symbol

date

trades

PREDICTIONS

2026-06-01

Download sample

trades

57661695455036831478287776153129850803351574978201924270494418960712051882696

2026-06-01

Download sample

book_ticker

97903420938606091954598995247916642127489952123621529862160273048309855576367

2026-06-01

Download sample

incremental_book_L2

27240772368842340548393958038359200077022257197570320676979474039971830802302

2026-06-01

Download sample

quotes

27240772368842340548393958038359200077022257197570320676979474039971830802302

2026-06-01

Download sample

book_snapshot_5

27240772368842340548393958038359200077022257197570320676979474039971830802302

2026-06-01

Download sample

book_snapshot_25

27240772368842340548393958038359200077022257197570320676979474039971830802302

2026-06-01

Download sample

API Access and data format

Historical data format is the same as provided by real-time Polymarket WebSocket APIs with addition of local timestamps. Polymarket symbols in Tardis.dev APIs are CLOB token IDs, not event slugs or market questions. In Polymarket market channel messages this identifier appears as asset_id.

Symbol filters apply to per-token market data such as book, price_change, last_trade_price, and best_bid_ask. Market-level channels such as tick_size_change, new_market, market_resolved, and sport_result do not require symbols.

If you'd like to work with normalized data format instead (same format for each exchange) see downloadable CSV files or official client libs that can perform data normalization client-side.

# pip install tardis-dev
import asyncio
from tardis_dev import Channel, replay

symbols = [
    "27240772368842340548393958038359200077022257197570320676979474039971830802302",
    "33657678411548069412646838419011738363351964246263910293068444617014480555282",
]

async def main():
    async for local_timestamp, message in replay(
        exchange="polymarket",
        from_date="2026-06-01",
        to_date="2026-06-02",
        filters=[
            Channel(name="price_change", symbols=symbols),
            Channel(name="book", symbols=symbols),
        ],
        api_key="YOUR_API_KEY",
    ):
        # messages as provided by Polymarket real-time stream
        print(local_timestamp, message)

asyncio.run(main())

See Python client docs.

// npm install tardis-dev
import { replay } from 'tardis-dev';

const symbols = [
  '27240772368842340548393958038359200077022257197570320676979474039971830802302',
  '33657678411548069412646838419011738363351964246263910293068444617014480555282'
];

const messages = replay({
  exchange: 'polymarket',
  from: '2026-06-01',
  to: '2026-06-02',
  filters: [
    { channel: 'price_change', symbols },
    { channel: 'book', symbols }
  ],
  apiKey: 'YOUR_API_KEY'
});

// messages as provided by Polymarket real-time stream
for await (const { localTimestamp, message } of messages) {
  console.log(localTimestamp, message);
}

See Node.js client docs.

filters='[
  {"channel":"price_change","symbols":[
    "27240772368842340548393958038359200077022257197570320676979474039971830802302",
    "33657678411548069412646838419011738363351964246263910293068444617014480555282"
  ]},
  {"channel":"book","symbols":[
    "27240772368842340548393958038359200077022257197570320676979474039971830802302",
    "33657678411548069412646838419011738363351964246263910293068444617014480555282"
  ]}
]'

curl --compressed --get 'https://api.tardis.dev/v1/data-feeds/polymarket' \
  --data-urlencode 'from=2026-06-01' \
  --data-urlencode "filters=${filters}" \
  --data-urlencode 'offset=0'

See HTTP API docs.

options='{
  "exchange":"polymarket",
  "filters":[
    {"channel":"price_change","symbols":[
      "27240772368842340548393958038359200077022257197570320676979474039971830802302",
      "33657678411548069412646838419011738363351964246263910293068444617014480555282"
    ]},
    {"channel":"book","symbols":[
      "27240772368842340548393958038359200077022257197570320676979474039971830802302",
      "33657678411548069412646838419011738363351964246263910293068444617014480555282"
    ]}
  ],
  "from":"2026-06-01",
  "to":"2026-06-02"
}'

curl --get 'http://localhost:8000/replay' \
  --data-urlencode "options=${options}"

Tardis-machine is a locally runnable server that exposes API allowing efficiently requesting historical market data for whole time periods in contrast to HTTP API that provides data only in minute by minute slices.

See tardis-machine docs.

Finding Polymarket symbols

Polymarket users usually start from an event, category, tag, slug, or market question. Tardis.dev replay filters need the matching CLOB token IDs. Polymarket's Gamma API exposes those token IDs in each market's clobTokenIds array; the indexes match the market's outcomes array. Binary markets usually have two token IDs, one for each outcome.

The examples below find event markets through the Gamma API, print several candidates with their outcome-to-symbol mapping, and replay raw Tardis.dev messages for both outcome tokens of the selected market.

# pip install tardis-dev
import asyncio
import json
from urllib.parse import urlencode
from urllib.request import urlopen

from tardis_dev import Channel, replay

params = urlencode({
    "tag_slug": "crypto",
    "order": "volume24hr",
    "ascending": "false",
    "limit": "20",
})

with urlopen(f"https://gamma-api.polymarket.com/events?{params}") as response:
    events = json.load(response)

candidates = []
for event in events:
    for market in event.get("markets", []):
        if market.get("enableOrderBook") and market.get("clobTokenIds"):
            outcomes = json.loads(market.get("outcomes") or "[]")
            symbols = json.loads(market["clobTokenIds"])
            candidates.append({
                "event": event["title"],
                "question": market["question"],
                "outcomes": list(zip(outcomes, symbols)),
            })

for candidate in candidates[:5]:
    print(candidate)

if not candidates:
    raise RuntimeError("No Polymarket CLOB markets matched these query parameters.")

symbols = [symbol for _, symbol in candidates[0]["outcomes"]]

async def main():
    async for local_timestamp, message in replay(
        exchange="polymarket",
        from_date="2026-06-01",
        to_date="2026-06-02",
        filters=[
            Channel(name="price_change", symbols=symbols),
            Channel(name="book", symbols=symbols),
        ],
        api_key="YOUR_API_KEY",
    ):
        print(local_timestamp, message)

asyncio.run(main())

// npm install tardis-dev
import { replay } from 'tardis-dev';

const params = new URLSearchParams({
  tag_slug: 'crypto',
  order: 'volume24hr',
  ascending: 'false',
  limit: '20'
});

const gammaUrl = `https://gamma-api.polymarket.com/events?${params}`;
const events = await fetch(gammaUrl).then((response) => response.json());
const candidates = events
  .flatMap((event) =>
    (event.markets ?? []).map((market) => ({
      event: event.title,
      market
    }))
  )
  .filter(({ market }) => market.enableOrderBook && market.clobTokenIds)
  .slice(0, 5)
  .map(({ event, market }) => {
    const outcomes = JSON.parse(market.outcomes ?? '[]');
    const symbols = JSON.parse(market.clobTokenIds);

    return {
      event,
      question: market.question,
      outcomes: outcomes.map((outcome, index) => ({ outcome, symbol: symbols[index] }))
    };
  });

console.dir(candidates, { depth: null });

if (candidates.length === 0) {
  throw new Error('No Polymarket CLOB markets matched these query parameters.');
}

const symbols = candidates[0].outcomes.map(({ symbol }) => symbol);
const messages = replay({
  exchange: 'polymarket',
  from: '2026-06-01',
  to: '2026-06-02',
  filters: [
    { channel: 'price_change', symbols },
    { channel: 'book', symbols }
  ],
  apiKey: 'YOUR_API_KEY'
});

for await (const { localTimestamp, message } of messages) {
  console.log(localTimestamp, message);
}

Captured real-time channels

Click any channel below to see HTTP API response with historical data recorded for it.

book Full order book snapshots on subscription and after trades that affect the book. Initial subscription data can include several book objects in one message.
price_change Price level updates from new or cancelled orders. A single message can include updates for multiple outcome tokens in price_changes[].
last_trade_price Trade execution updates
best_bid_ask Best bid and ask price updates
tick_size_change Minimum tick size changes. This is a market-level event; symbol filters do not narrow results.
new_market New market creation events with market metadata. This is a market-level event; symbol filters do not narrow results.
market_resolved Market resolution events with winning outcome metadata. This is a market-level event; symbol filters do not narrow results.
sport_result Live sports scores, periods, and game status updates. This channel is collected from Polymarket's separate Sports WebSocket and is not symbol-filtered.

Market data collection details

Market data collection infrastructure for Polymarket is located in GCP europe-west2 (London, Europe).

Polymarket's exchange infrastructure is located in AWS eu-west-2 (London, Europe).

CLOB market data is captured via Cloudflare-proxied WebSocket connections to wss://ws-subscriptions-clob.polymarket.com/ws/market. Sports results are captured from Polymarket's separate Sports WebSocket at wss://sports-api.polymarket.com/ws.

PreviousLighter NextBullish

Last updated 29 days ago

Was this helpful?