Docs menu

Polymarket API endpoint

Polymarket token spreads API

Returns public CLOB spreads 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.BatchTokenSpreadsOptionpolymarket.batchTokenSpreadsResponseDoc/polymarket/tokens/spreads

Endpoint facts

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

Polymarket Scraper API Try Polymarket token spreads 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 spread values 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/spreads" \
  -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"
    ],
    "spreads": [
      {
        "token_id": "81927025054404355287140018940169293739219157042658469116956164881873598220211",
        "spread": 0.51
      }
    ]
  }
}

Request schema

#/definitions/polymarket.BatchTokenSpreadsOption

Field	Type	Required	Enum	Bounds	Example	Description
token_ids	array	Yes

Response schema

#/definitions/polymarket.batchTokenSpreadsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.BatchTokenSpreadsResponse	No
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 spread was returned.
data.source_url	string	No	https://clob.polymarket.com/spreads	URL the data was read from.
data.spreads	array	No		Spreads for the requested tokens, one item per token found.
data.spreads[].spread	number	No	0.51	Spread between the best bid and best ask for the token.
data.spreads[].token_id	string	No	81927025054404355287140018940169293739219157042658469116956164881873598220211	Token id of the outcome.
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/spreads" \
  -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 spreads API

Returns public CLOB spreads 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.BatchTokenSpreadsOptionpolymarket.batchTokenSpreadsResponseDoc/polymarket/tokens/spreads

Endpoint facts

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

Polymarket Scraper API Try Polymarket token spreads 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 spread values 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/spreads" \
  -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"
    ],
    "spreads": [
      {
        "token_id": "81927025054404355287140018940169293739219157042658469116956164881873598220211",
        "spread": 0.51
      }
    ]
  }
}

Request schema

#/definitions/polymarket.BatchTokenSpreadsOption

Field	Type	Required	Enum	Bounds	Example	Description
token_ids	array	Yes

Response schema

#/definitions/polymarket.batchTokenSpreadsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	polymarket.BatchTokenSpreadsResponse	No
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 spread was returned.
data.source_url	string	No	https://clob.polymarket.com/spreads	URL the data was read from.
data.spreads	array	No		Spreads for the requested tokens, one item per token found.
data.spreads[].spread	number	No	0.51	Spread between the best bid and best ask for the token.
data.spreads[].token_id	string	No	81927025054404355287140018940169293739219157042658469116956164881873598220211	Token id of the outcome.
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/spreads" \
  -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 spreads 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 spreads API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Request body example

Example JSON response

Failure responses

Code examples

Shared guides

Related