Skip to main content
GET
Order book
Returns the full order book for a Polymarket token or market.

Identifier types

The {token_id} parameter accepts three identifier types. The response format depends on which type you use:

By token ID (single outcome)

Best when you already have a specific token ID and want the exact Polymarket-compatible format.
Response matches Polymarket’s CLOB /book format exactly, plus a metadata field:

By condition ID (both outcomes)

Best when you want both sides of a market at once. Condition IDs start with 0x.
Response wraps both outcomes:

By slug (all outcomes across markets)

Best for getting a complete view of an event. Slugs are the human-readable event identifiers from Polymarket (e.g. netanyahu-out-before-2027). An event may have multiple markets, each with their own outcomes.
Response includes all outcomes across all markets in the event. Same format as the condition ID response, but with slug instead of condition_id at the top level.

Fields (single-token response)

Notes

  • tick_size and min_order_size vary per market. They are sourced from the Gamma API, not hardcoded.
  • Bids are sorted ascending by price (best bid is the last element). Asks are sorted descending (best ask is the last element). This matches Polymarket’s sort order.
  • If no book exists for the requested identifier, returns a 404 with {"error": "No orderbook exists for the requested token id"}.

Authorizations

x-api-key
string
header
required

Path Parameters

token_id
string
required

Token ID (all digits), condition ID (starts with 0x), or event slug. Token ID returns a single book; condition ID and slug return all outcomes.

Response

Order book snapshot

Full order book snapshot. Base fields match Polymarket's CLOB /book response exactly. The metadata field is a PolyNode addition.

market
string
required

Market condition ID (hex)

asset_id
string
required

Token ID

timestamp
string
required

Unix timestamp in milliseconds (as string)

hash
string
required

40-character hex hash of the book state

bids
object[]
required

Bid price levels, sorted ascending by price

asks
object[]
required

Ask price levels, sorted descending by price

min_order_size
string
required

Minimum order size for this market (e.g. "5")

tick_size
string
required

Minimum price increment for this market (e.g. "0.01" or "0.001")

neg_risk
boolean
required

Whether this is a neg-risk market

last_trade_price
string
required

Last trade price (e.g. "0.540")

metadata
object

PolyNode market metadata enrichment (not present in Polymarket's CLOB API).