Polymarket API reference / CLOB API
POST/midpoints

Get midpoint prices (request body)

Retrieves midpoint prices for multiple token IDs using a request body. The midpoint is calculated as the average of the best bid and best ask prices.

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

Request body

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

Example

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

Responses

StatusMeaning
200Successfully retrieved midpoint prices
400Bad request - Invalid payload
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.