Skip to main content
GET
/
api
/
v1
/
poly
/
{poly_id}
/
top_of_book
[
  {
    "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

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

​
top_5_asks
object[]

Top 5 ask price levels

​
last_update
string<date-time>

Last update timestamp