[
  {
    "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"
  }
]

{
  "error": "<string>"
}

Polymarket

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

Example

Request: GET /api/v1/poly/0x0430a1879133a6416efe8c2076190336b8665abf9b67c45dadfc312ab7b413e6/top_of_book?limit=10
Header: X-API-Key: YOUR_API_KEY

GET

api

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"
  }
]

{
  "error": "<string>"
}

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

Show child attributes

top_5_asks

object[]

Top 5 ask price levels

Show child attributes

last_update

string<date-time>

Last update timestamp

Getting Started

Health

Auth

Search

Delphi

Clusters

KLSI

Polymarket

Limitless

Predict.fun

Gemini

Manifold

ForecastEx

PredictIt

Opinion Labs

Candles

Events

Advanced Analytics

Get Polymarket Top of Book

What you get

Use cases

Example

Authorizations

Path Parameters

Query Parameters

Response