Market Orderbook

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Returns a current, point-in-time snapshot of the full bid/ask order book — there is no date-range parameter or historical look-back, and it reflects the latest available state within the standard live latency.

Get Prediction Market Orderbook

post

Get the full bid/ask orderbook for a Polymarket prediction market. Data is polled from the Polymarket CLOB API every ~60 seconds with MD5 change detection.

What it helps to answer:

1. What is the current bid/ask depth for a prediction market?

2. How much liquidity is available at each price level?

3. What is the current spread?

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Request for orderbook endpoint.

market_idstring · min: 1 · max: 100Required

Polymarket market ID

Example: 654412

Responses

200

Orderbook data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/prediction-market/orderbook

HTTPcURLJavaScriptPython

POST /api/v1/prediction-market/orderbook HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "market_id": "654412",
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "market_id": "654412",
      "event_id": "text",
      "outcome": "Yes",
      "outcome_index": 1,
      "asset_id": "71321045679252212",
      "side": "buy",
      "price": 0.52,
      "size": 1000,
      "cumulative_size": 5000,
      "snapshot_timestamp": "2024-11-01T12:00:00"
    }
  ]
}