Skip to main content
GET
/
api
/
v1
/
polymarket
/
market
/
orderbook-summary
Get Polymarket Orderbook Summary
curl --request GET \
  --url https://api.entityml.com/api/v1/polymarket/market/orderbook-summary \
  --header 'Authorization: <authorization>'
{
  "market_condition_id": "<string>",
  "date": "<string>",
  "resolution_seconds": 123,
  "data_points": 123,
  "data": [
    {}
  ]
}

​
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.
​
date
string
required
The date to summarize, formatted as YYYY-MM-DD.
​
resolution
integer
Time bucket resolution in seconds. Default: 60. Valid range: 1 to 3600.

​
Response

​
market_condition_id
string
The Polymarket market condition ID.
​
date
string
The requested date.
​
resolution_seconds
integer
The bucket size used to build the summary.
​
data_points
integer
Number of summary points returned.
​
data
array
Array of time buckets with timestamp, best_bid, best_bid_size, best_ask, and best_ask_size. Bid and ask values may be null until that side of the book has been observed.
The legacy alias GET /api/v1/market/orderbook-summary remains available for existing integrations.

​
Example

from poly_storage_sdk import PolyStorageClient

client = PolyStorageClient(api_key="YOUR_API_KEY")

summary = client.polymarket.get_orderbook_summary(
    condition_id="0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4",
    date="2026-02-13",
    resolution=60,
)

print(summary["data_points"])

​
Example response

{
  "market_condition_id": "0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4",
  "date": "2026-02-13",
  "resolution_seconds": 60,
  "data_points": 1440,
  "data": [
    {
      "timestamp": 1770940800000,
      "best_bid": 0.12,
      "best_bid_size": 4361.9,
      "best_ask": 0.15,
      "best_ask_size": 4361.9
    }
  ]
}