Skip to main content
GET
Get Polymarket Market Data Range

Request

Headers

string
required
Bearer token. Example: Bearer YOUR_API_KEY

Query Parameters

string
required
The Polymarket market condition ID. Values are accepted with or without the 0x prefix and normalized in the response.
integer
required
Inclusive lower timestamp bound. Accepts Unix seconds or milliseconds.
integer
required
Inclusive upper timestamp bound. Accepts Unix seconds or milliseconds.
string
Opaque cursor returned by the previous page for the same market and timestamp range.
integer
Maximum number of records to return per page. Default: 10000. Max: 100000.

Response

string
The normalized market condition ID with the 0x prefix.
integer
Inclusive lower timestamp bound normalized to milliseconds.
integer
Inclusive upper timestamp bound normalized to milliseconds.
integer
Number of records returned in the current page.
array
Array of raw Polymarket events matching the requested range.
object
Cursor pagination metadata.
The legacy alias GET /api/v1/market/data/range remains available for existing integrations.
This endpoint rejects timestamp ranges earlier than 2026-02-08T00:00:00Z, even though some backfilled Polymarket storage exists earlier for a subset of markets.

Example

Example response

next_cursor is opaque. Pass it back unchanged with the same condition_id, start_timestamp, and end_timestamp to continue paging.