Skip to main content
GET
https://api.entityml.com
/
api
/
v1
/
market
/
data
Get Market Data
curl --request GET \
  --url https://api.entityml.com/api/v1/market/data \
  --header 'Authorization: <authorization>'
{
  "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": 123
    }
  ]
}

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer YOUR_API_KEY

​
Query Parameters

​
condition_id
string
required
The unique identifier for the market condition. You can find this using the helper scripts or from the Polymarket URL.
​
date
string
required
The date for which to retrieve market data, formatted as YYYY-MM-DD. Data is only available from 2025-02-08 onwards.

​
Response

​
market_condition_id
string
The unique identifier for the market condition (with 0x prefix).
​
date
string
The date of the market data.
​
data_count
number
Total number of data entries returned.
​
data
array
Array of market data events. Each event contains:

​
Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.entityml.com/api/v1/market/data?condition_id=0008043c3ed513ecff7ee64380fc943dc73eb3dfb6674f281149efe4769f7515&date=2025-09-03"

​
Example response

{
  "market_condition_id": "0x0008043c3ed513ecff7ee64380fc943dc73eb3dfb6674f281149efe4769f7515",
  "date": "2025-09-03",
  "data_count": 803,
  "data": [
    {
      "market": "0x0008043c3ed513ecff7ee64380fc943dc73eb3dfb6674f281149efe4769f7515",
      "asset_id": "97684905927345553455494278582909124912046930226695064344571162061840768197777",
      "timestamp": "1756876719390",
      "hash": "00dc3336e59feb0bd4974390e62287b3d1c59c3b",
      "bids": [
        { "price": "0.01", "size": "1000" },
        { "price": "0.02", "size": "5" }
      ],
      "asks": [
        { "price": "0.99", "size": "310000" },
        { "price": "0.98", "size": "60010.94" },
        { "price": "0.97", "size": "10.41" }
      ],
      "event_type": "book",
      "received_at": 1756877357936
    },
    {
      "asset_id": "97684905927345553455494278582909124912046930226695064344571162061840768197777",
      "changes": [
        { "price": "0.02", "side": "BUY", "size": "0" }
      ],
      "event_type": "price_change",
      "hash": "56bb09006ea4691106084133fc430d05c45304ce",
      "market": "0x0008043c3ed513ecff7ee64380fc943dc73eb3dfb6674f281149efe4769f7515",
      "timestamp": "1756877439011",
      "received_at": 1756877439060
    }
  ]
}