GET /v1/orderbook/:token_id

Returns the full CLOB orderbook for a market token, including all bid/ask levels, spread, and depth metrics.

Path Parameters

Parameter	Type	Description
`token_id`	string	Polymarket CLOB token identifier

Request

curl -s https://polynode.dev/v1/orderbook/21742633... \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "token_id": "21742633...",
  "question": "Will Bitcoin hit $100K in 2026?",
  "slug": "bitcoin-100k-2026",
  "outcomes": ["Yes", "No"],
  "condition_id": "0xabc123...",
  "min_order_size": 5.0,
  "tick_size": 0.01,
  "best_bid": 0.71,
  "best_ask": 0.73,
  "spread": 0.02,
  "mid_price": 0.72,
  "bid_depth": 45230.00,
  "ask_depth": 38120.00,
  "bid_levels": 15,
  "ask_levels": 12,
  "bids": [
    ["0.71", "1500.00"],
    ["0.70", "3200.00"],
    ["0.69", "2100.00"]
  ],
  "asks": [
    ["0.73", "2100.00"],
    ["0.74", "1800.00"],
    ["0.75", "4500.00"]
  ],
  "updated_at": 1709136050000
}

Response Fields

Field	Type	Description
`token_id`	string	Token identifier
`best_bid`	number	Highest bid price
`best_ask`	number	Lowest ask price
`spread`	number	Bid-ask spread
`mid_price`	number	Midpoint of best bid and ask
`bid_depth`	number	Total bid-side liquidity in USD
`ask_depth`	number	Total ask-side liquidity in USD
`bid_levels`	integer	Number of bid price levels
`ask_levels`	integer	Number of ask price levels
`bids`	[string, string][]	Bid levels as [price, size] pairs
`asks`	[string, string][]	Ask levels as [price, size] pairs
`updated_at`	integer	Last update timestamp (Unix ms)
`min_order_size`	number	Minimum order size for this market
`tick_size`	number	Price tick increment

Errors

Status	Description
404	No orderbook data — market may not be subscribed via CLOB