GET/spread

Get spread

Retrieves the spread for a specific token ID. The spread is the difference between the best ask and best bid prices.

Base URL: https://clob.polymarket.com
Auth: Public, no key
Rate limit: 9,000 req / 10s (900 per second)
Limit applies to: CLOB API general

Parameters

Name	In	Type	Required	Description
token_id	query	string	yes	Token ID (asset ID)

Example

curl -X GET "https://clob.polymarket.com/spread?token_id=<token_id>"

Response fields

Field	Type	Description
spread	string	Spread as a string

Responses

Status	Meaning
200	Successfully retrieved spread
400	Bad request - Invalid token id
404	Not found - No orderbook exists for the requested token id

Errors this endpoint returns

Related endpoints

POST /spreads CLOB API

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.