Skip to main content
GET
/
v2
/
data
/
ticks
Download Tick Data
curl --request GET \
  --url https://api.predexon.com/v2/data/ticks \
  --header 'x-api-key: <api-key>'
{
  "venue": "<string>",
  "status": "final",
  "format": "parquet",
  "compression": "zstd",
  "schema": [
    {
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "sort_order": [
    "<string>"
  ],
  "parts": [
    {
      "url": "<string>",
      "rows": 123,
      "bytes": 123,
      "expires_at": "<string>",
      "id_min": "<string>",
      "id_max": "<string>",
      "ts_min": 123,
      "ts_max": 123
    }
  ],
  "total_rows": 123,
  "total_bytes": 123,
  "date": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "start_time": 123,
  "end_time": 123,
  "market_id": "<string>"
}
Download the raw price-change firehose behind Polymarket — every top-of-book update at full resolution, as sorted, zstd-compressed Parquet. Call with venue=polymarket; feed the signed URLs into your own DuckDB, Polars, or Spark.
Releasing soon — not publicly reachable yet. Polymarket Ticks is in a gated private preview. The endpoint is live but access is restricted: a standard API key is rejected until the dataset is enabled on your account. This page documents the contract so you can build ahead of launch. Request early access →
Finalized data only (T-1). Ticks are compacted daily at 06:00 UTC; today/future days return 404 not_final. For real-time updates use the WebSocket Orderbook channel.
ConstraintValue
Date rangeUp to 31 days per request
Signed URL TTL~1 hour (expires_at)
Day selectionexactly one of date, start_date+end_date, or start_time+end_time
Timestamps are epoch milliseconds, UTC. Pass market_id to prune a day down to 1–2 files (Parquet is sorted by market_id).

​
Schema

Top-of-book price changes, sorted by (market_id, asset_id, ts_ms).
ColumnTypeNotes
market_idstringCondition / market identifier
asset_idstringOutcome token ID
ts_msint64Event time (epoch ms)
received_atint64Ingest time (epoch ms)
sidestringbuy / sell
pricestringPrice (decimal string)
sizestringSize at the level
best_bidstringBest bid at the time
best_askstringBest ask at the time
Want JSON rows instead of files? GET /v2/data/ticks/query?venue=polymarket&market_id=…&start_time=…&end_time=… runs a server-side DuckDB query (no storage URL exposed). Other venues: Kalshi Ticks, Opinion Ticks.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
venue
enum<string>
required

Dataset key: polymarket (CLOB price changes), kalshi, or opinion (orderbook deltas). Dataset key.

Available options:
polymarket,
kalshi,
opinion
​
date
string | null

Single UTC day, YYYY-MM-DD.

​
start_date
string | null

Range start, YYYY-MM-DD (pair with end_date).

​
end_date
string | null

Range end, YYYY-MM-DD (inclusive).

​
start_time
integer | null

Window start, epoch ms UTC. Selects/derives days and prunes parts by ts range.

​
end_time
integer | null

Window end, epoch ms UTC (inclusive).

​
market_id
string | null

Prune to the part(s) covering this market/ticker.

Response

Successful Response

Signed-URL download response for a venue/date (or date range).

​
venue
string
required
​
status
string
default:final
required
​
format
string
default:parquet
required
​
compression
string
default:zstd
required
​
schema
TickSchemaField · object[]
required

Column names and types in the Parquet files.

​
sort_order
string[]
required

Columns the files are globally sorted by.

​
parts
TickPart · object[]
required
​
total_rows
integer
required
​
total_bytes
integer
required
​
date
string | null
​
start_date
string | null
​
end_date
string | null
​
start_time
integer | null
​
end_time
integer | null
​
market_id
string | null