Polymarket API reference / CLOB API
GET/prices

Get market prices (query parameters)

Retrieves market prices for multiple token IDs and sides using query parameters.

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

Parameters

NameInTypeRequiredDescription
token_idsquerystringyesComma-separated list of token IDs
sidesquerystringyesComma-separated list of sides (BUY or SELL) corresponding to token IDs

Example

curl -X GET "https://clob.polymarket.com/prices?token_ids=<token_ids>&sides=<sides>"

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

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.