Polymarket API reference / CLOB API
POST/prices

Get market prices (request body)

Retrieves market prices for multiple token IDs and sides using a request body. Each request must include both token_id and side.

Base URL
https://clob.polymarket.com
Auth
Public, no key
Rate limit
500 req / 10s (50 per second)
Limit applies to
/prices

Request body

FieldTypeRequiredDescription
token_idstringyesToken ID (asset ID)
sidestringnoOrder side (optional, not used for midpoint calculation)

Example

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

Responses

StatusMeaning
200Successfully retrieved market prices
400Bad request - Invalid payload or side
404Not found - No orderbook exists for the requested token id
500Internal server error

Errors this endpoint returns

Related endpoints

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.