Docs menu

Polymarket API endpoint

Polymarket token order books API

Returns public CLOB order-book depth for up to 25 Polymarket token ids. This does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.

POSTapiKey0 credits/requestPolymarketpolymarket.BatchTokenOrderBooksOptionpolymarket.batchTokenOrderBooksResponseDoc/polymarket/tokens/orderbooks

Endpoint facts

Method: POST
API path: /polymarket/tokens/orderbooks
Auth: apiKey
Credits: 0 credits/request
Charged on: Successful 2xx responses only
Platform: Polymarket
Response schema: #/definitions/polymarket.batchTokenOrderBooksResponseDoc
Request body schema: #/definitions/polymarket.BatchTokenOrderBooksOption

Polymarket Scraper API Try Polymarket token order books API in Playground Polymarket API documentation

How this endpoint behaves

Body parameters:

token_ids: required array of Polymarket CLOB token ids. Maximum 25 ids.

Notable response behavior:

Returns public CLOB order-book depth for each matching token id.
This is a public CLOB market-data read. It does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Duplicate token ids are de-duplicated before the upstream request.
Missing upstream rows are reported in missing when at least one requested token returns data.

Example request:

{
  "token_ids": [
    "81927025054404355287140018940169293739219157042658469116956164881873598220211"
  ]
}

Request parameters

Parameter	Type	Required	Default	Description	Example
body (body)	object	Yes		Token ids request body
x-api-key (header)	string	Yes		API key required

cURL example

curl -X POST "https://api.crawlora.net/api/v1/polymarket/tokens/orderbooks" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token_ids":["string"]}'

Request body example

{
  "token_ids": [
    "string"
  ]
}

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "token_ids": [
      "81927025054404355287140018940169293739219157042658469116956164881873598220211"
    ],
    "books": [
      {
        "condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
        "token_id": "81927025054404355287140018940169293739219157042658469116956164881873598220211",
        "bids": [
          {
            "price": 0.03,
            "size": 5
          }
        ],
        "asks": [
          {
            "price": 0.54,
            "size": 500
          }
        ]
      }
    ]
  }
}

Request schema

#/definitions/polymarket.BatchTokenOrderBooksOption

Field	Type	Required	Enum	Bounds	Example	Description
token_ids	array	Yes

Response schema

#/definitions/polymarket.batchTokenOrderBooksResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.BatchTokenOrderBooksResponse	No
data.books	array	No		Order books for the requested tokens, one item per token found.
data.books[].asks	array	No		Ask levels in the order book, one item per price level.
data.books[].asks[].price	number	No	0.03	Price of this order book level.
data.books[].asks[].size	number	No	5	Total size of the orders resting at this price.
data.books[].bids	array	No		Bid levels in the order book, one item per price level.
data.books[].bids[].price	number	No	0.03	Price of this order book level.
data.books[].bids[].size	number	No	5	Total size of the orders resting at this price.
data.books[].condition_id	string	No	0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327	Condition id of the market the token belongs to.
data.books[].hash	string	No	31facd52b62495bbc142facb81275400d978f6bf	Hash of the order book snapshot.
data.books[].last_trade_price	number	No	0.285	Price of the most recent trade on the token.
data.books[].min_order_size	number	No	5	Smallest order size the market accepts.
data.books[].neg_risk	boolean	No		`true` when the market is part of a negative-risk group of linked outcomes.
data.books[].tick_size	number	No	0.01	Smallest price increment the market accepts.
data.books[].timestamp	string	No	1780837460175	Time of the order book snapshot, in Unix milliseconds.
data.books[].token_id	string	No	81927025054404355287140018940169293739219157042658469116956164881873598220211	Token id of the outcome the order book belongs to.
data.fetched_at	string	No	2026-06-07T11:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.missing	array	No		Requested token ids for which no order book was returned.
data.source_url	string	No	https://clob.polymarket.com/books	URL the data was read from.
data.token_ids	array	No		Token ids that were requested.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X POST "https://api.crawlora.net/api/v1/polymarket/tokens/orderbooks" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token_ids":["string"]}'

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Polymarket endpoint docs Polymarket Scraper API Polymarket activity trades API documentation Polymarket CLOB market API documentation Polymarket macro dashboard API documentation Polymarket data followers API documentation Polymarket data following API documentation Polymarket data follow counts API documentation

Open in Playground Back to group

Docs menu

Polymarket API endpoint

Polymarket token order books API

Returns public CLOB order-book depth for up to 25 Polymarket token ids. This does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.

POSTapiKey0 credits/requestPolymarketpolymarket.BatchTokenOrderBooksOptionpolymarket.batchTokenOrderBooksResponseDoc/polymarket/tokens/orderbooks

Endpoint facts

Method: POST
API path: /polymarket/tokens/orderbooks
Auth: apiKey
Credits: 0 credits/request
Charged on: Successful 2xx responses only
Platform: Polymarket
Response schema: #/definitions/polymarket.batchTokenOrderBooksResponseDoc
Request body schema: #/definitions/polymarket.BatchTokenOrderBooksOption

Polymarket Scraper API Try Polymarket token order books API in Playground Polymarket API documentation

How this endpoint behaves

Body parameters:

token_ids: required array of Polymarket CLOB token ids. Maximum 25 ids.

Notable response behavior:

Returns public CLOB order-book depth for each matching token id.
This is a public CLOB market-data read. It does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Duplicate token ids are de-duplicated before the upstream request.
Missing upstream rows are reported in missing when at least one requested token returns data.

Example request:

{
  "token_ids": [
    "81927025054404355287140018940169293739219157042658469116956164881873598220211"
  ]
}

Request parameters

Parameter	Type	Required	Default	Description	Example
body (body)	object	Yes		Token ids request body
x-api-key (header)	string	Yes		API key required

cURL example

curl -X POST "https://api.crawlora.net/api/v1/polymarket/tokens/orderbooks" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token_ids":["string"]}'

Request body example

{
  "token_ids": [
    "string"
  ]
}

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "token_ids": [
      "81927025054404355287140018940169293739219157042658469116956164881873598220211"
    ],
    "books": [
      {
        "condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
        "token_id": "81927025054404355287140018940169293739219157042658469116956164881873598220211",
        "bids": [
          {
            "price": 0.03,
            "size": 5
          }
        ],
        "asks": [
          {
            "price": 0.54,
            "size": 500
          }
        ]
      }
    ]
  }
}

Request schema

#/definitions/polymarket.BatchTokenOrderBooksOption

Field	Type	Required	Enum	Bounds	Example	Description
token_ids	array	Yes

Response schema

#/definitions/polymarket.batchTokenOrderBooksResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.BatchTokenOrderBooksResponse	No
data.books	array	No		Order books for the requested tokens, one item per token found.
data.books[].asks	array	No		Ask levels in the order book, one item per price level.
data.books[].asks[].price	number	No	0.03	Price of this order book level.
data.books[].asks[].size	number	No	5	Total size of the orders resting at this price.
data.books[].bids	array	No		Bid levels in the order book, one item per price level.
data.books[].bids[].price	number	No	0.03	Price of this order book level.
data.books[].bids[].size	number	No	5	Total size of the orders resting at this price.
data.books[].condition_id	string	No	0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327	Condition id of the market the token belongs to.
data.books[].hash	string	No	31facd52b62495bbc142facb81275400d978f6bf	Hash of the order book snapshot.
data.books[].last_trade_price	number	No	0.285	Price of the most recent trade on the token.
data.books[].min_order_size	number	No	5	Smallest order size the market accepts.
data.books[].neg_risk	boolean	No		`true` when the market is part of a negative-risk group of linked outcomes.
data.books[].tick_size	number	No	0.01	Smallest price increment the market accepts.
data.books[].timestamp	string	No	1780837460175	Time of the order book snapshot, in Unix milliseconds.
data.books[].token_id	string	No	81927025054404355287140018940169293739219157042658469116956164881873598220211	Token id of the outcome the order book belongs to.
data.fetched_at	string	No	2026-06-07T11:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.missing	array	No		Requested token ids for which no order book was returned.
data.source_url	string	No	https://clob.polymarket.com/books	URL the data was read from.
data.token_ids	array	No		Token ids that were requested.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X POST "https://api.crawlora.net/api/v1/polymarket/tokens/orderbooks" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token_ids":["string"]}'

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Polymarket token order books API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Request body example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Polymarket token order books API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Request body example

Example JSON response

Failure responses

Code examples

Shared guides

Related