POST/spreads

Get spreads

Retrieves spreads for multiple token IDs. 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

Request body

Field	Type	Required	Description
token_id	string	yes	Token ID (asset ID)
side	string	no	Order side (optional, not used for midpoint calculation)

Example

curl -X POST "https://clob.polymarket.com/spreads" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "token_id": "<token_id>"
  }
]'

Responses

Status	Meaning
200	Successfully retrieved spreads
400	Bad request - Invalid payload
500	Internal server error

Errors this endpoint returns

Related endpoints

GET /spread 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.