Get Polymarket Market Data

Retrieve raw Polymarket order book events for a specific market condition and UTC date.

GET /api/v1/polymarket/market/data

Get Polymarket Market Data

cURL

curl --request GET \
  --url https://api.entityml.com/api/v1/polymarket/market/data \
  --header 'Authorization: <authorization>'

200

{
  "market_condition_id": "<string>",
  "date": "<string>",
  "data_count": 123,
  "data": [
    {
      "market": "<string>",
      "asset_id": "<string>",
      "timestamp": "<string>",
      "hash": "<string>",
      "event_type": "<string>",
      "bids": [
        {}
      ],
      "asks": [
        {}
      ],
      "changes": [
        {}
      ],
      "received_at": "<string>",
      "worker_id": 123
    }
  ],
  "pagination": {}
}

Request

Headers

Authorization · string · required

Bearer token. Example: Bearer YOUR_API_KEY

Query Parameters

condition_id · string · required

The Polymarket market condition ID. Values are accepted with or without the 0x prefix and normalized in the response. If you only have a slug or Polymarket URL, use Look Up Polymarket Slug.

date · string · required

UTC date in YYYY-MM-DD format. Orderbook data exists for a subset of Polymarket markets from 2025-09-01, but coverage is not continuous. Broad Polymarket crypto-related coverage begins on 2026-02-04, and broad all-market capture begins on 2026-04-02, with known April 2026 quality exceptions. This endpoint currently rejects dates earlier than 2026-02-08. Use Get Polymarket Market Date Range to inspect stored availability for a specific market.

offset · integer

Number of filtered records to skip. Default: 0.

limit · integer

Maximum number of filtered records to return. Default: 10000. Max: 100000.

Response

market_condition_id · string

The normalized market condition ID with the 0x prefix.

date · string

The requested UTC date.

data_count · integer

Number of records returned in the current page.

data · array

Array of raw Polymarket events. Each event can include the following fields:

Show Event fields

market · string

Market condition ID.

asset_id · string

CLOB token ID.

timestamp · string

Event timestamp in milliseconds.

hash · string

Unique hash for the event.

event_type · string

Event type, typically "book" or "price_change".

bids · array

Array of bid orders with price and size fields. Present on snapshot-style records.

asks · array

Array of ask orders with price and size fields. Present on snapshot-style records.

changes · array

Array of price changes with price, side, and size fields. Present on incremental records.

received_at · string

ISO timestamp when the event was recorded.

worker_id · integer

Internal ingestion worker identifier when present.

pagination · object

Pagination metadata with offset, limit, total_count, and has_more.

The legacy alias GET /api/v1/market/data remains available for existing integrations.

For arbitrary windows across one or more days, use Get Polymarket Market Data Range.

Example

Python SDK

from entityml import EntityMLClient

client = EntityMLClient(api_key="YOUR_API_KEY")

data = client.polymarket.get_market_data(
    condition_id="0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4",
    date="2026-03-20",
)

print(data["data_count"])

Example response

{
  "market_condition_id": "0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4",
  "date": "2026-03-20",
  "data_count": 47,
  "data": [
    {
      "market": "0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4",
      "asset_id": "97684905927345553455494278582909124912046930226695064344571162061840768197777",
      "timestamp": "1773966061736",
      "hash": "98894e2c3a5764942f6e6b8183b18cb330985975",
      "bids": [],
      "asks": [
        { "price": "0.99", "size": "310000" }
      ],
      "event_type": "book",
      "received_at": "2026-03-20T00:21:03.548509",
      "worker_id": 24
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 500,
    "total_count": 47,
    "has_more": false
  }
}