Market Price (Polymarket)
ADMIN-ONLY (gated, not yet public). Current or historical mid price for a Polymarket outcome token. Defaults to the most recent price within the last hour. Pass `timestamp` (unix seconds) for a historical lookup — returns the closest data point within ±1 hour. Source: clob.polymarket.com/prices-history.
/v2/polymarket/market-price/{token_id}Query Parameters
Polymarket outcome token ID (path parameter).
Optional. Unix timestamp (seconds) for historical lookup. If omitted, returns the latest price.
Response Schema
Polymarket outcome token ID (the requested token).
Unix timestamp (seconds) of the returned price point.
Mid price (0–1).
Metadata about the source.
Always polymarket_clob_prices_history.
Authentication
API Key
To secure your requests, we strongly recommend passing your API key via the X-API-Key header. This prevents sensitive keys from being exposed in access logs or browser history.
X-API-Key: pmx_test_5e8f...Rate Limits
API rate limits are enforced based on the tier associated with your API key. Limits are tracked on two dimensions: requests per second and requests per month. Each completed request counts toward the global monthly quota. Separate endpoint-group monthly limits (matched markets, arbitrage, EV) only advance when the response body has success: true.
Usage is returned on responses via headers such as:
X-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842Example (endpoint-group, when applicable)X-RateLimit-Limit-Arb-Month: 500X-RateLimit-Remaining-Arb-Month: 412If you exceed a rate limit, the API returns a 429 status with a Retry-After header indicating when you can resume.
Request
Live API Key
Parameters
Response
—Click EXECUTE to send a request →