Get Polymarket Top of Book

Retrieve top-of-book best bid/ask data for a Polymarket market, including the top 5 price levels on each side.

What you get:

• Best bid and ask prices
• Top 5 bid and ask price levels with sizes
• Token ID and market ID
• Timestamps

Use cases:

• Monitor real-time best quotes
• Track top-of-book depth
• Build spread analytics

GET /api/v1/poly/{poly_id}/top_of_book

200

[
  {
    "exchange": "<string>",
    "token_id": "<string>",
    "market_id": "<string>",
    "best_bid": 123,
    "best_ask": 123,
    "top_5_bids": [
      {
        "price": 123,
        "size": 123
      }
    ],
    "top_5_asks": [
      {
        "price": 123,
        "size": 123
      }
    ],
    "last_update": "2023-11-07T05:31:56Z"
  }
]

Authorizations

X-API-Key · string · header · required

Your API key (get one from the test-key endpoint above)

Path Parameters

poly_id · string · required

Polymarket condition ID

Query Parameters

limit · integer · default: 10

Maximum number of rows to return (default: 10 in docs, max: 10000). Use a higher limit in your code.

Response

200

application/json

Top of book data

exchange · string

Exchange identifier

token_id · string

Token identifier

market_id · string

Market identifier

best_bid · number

Best bid price as decimal

best_ask · number

Best ask price as decimal

top_5_bids · object[]

Top 5 bid price levels

Show child attributes

top_5_asks · object[]

Top 5 ask price levels

Show child attributes

last_update · string<date-time>

Last update timestamp