Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt

Use this file to discover all available pages before exploring further.

All API rate limits are enforced using Cloudflare’s throttling system. When you exceed the limit for any endpoint, requests are throttled (delayed/queued) rather than immediately rejected. Limits reset on sliding time windows.

General

EndpointLimit
General rate limiting15,000 req / 10s
Health check (/ok)100 req / 10s

Gamma API

Base URL: https://gamma-api.polymarket.com
EndpointLimit
General4,000 req / 10s
/events500 req / 10s
/markets300 req / 10s
/markets + /events listing900 req / 10s
/comments200 req / 10s
/tags200 req / 10s
/public-search350 req / 10s

Data API

Base URL: https://data-api.polymarket.com
EndpointLimit
General1,000 req / 10s
/trades200 req / 10s
/positions150 req / 10s
/closed-positions150 req / 10s
Health check (/ok)100 req / 10s

CLOB API

Base URL: https://clob.polymarket.com

General

EndpointLimit
General9,000 req / 10s
GET balance allowance200 req / 10s
UPDATE balance allowance50 req / 10s

Market Data

EndpointLimit
/book1,500 req / 10s
/books500 req / 10s
/price1,500 req / 10s
/prices500 req / 10s
/midpoint1,500 req / 10s
/midpoints500 req / 10s
/prices-history1,000 req / 10s
Market tick size200 req / 10s

Ledger

EndpointLimit
/trades, /orders, /notifications, /order900 req / 10s
/data/orders500 req / 10s
/data/trades500 req / 10s
/notifications125 req / 10s

Authentication

EndpointLimit
API key endpoints100 req / 10s

Trading

Trading endpoints have both burst limits (short spikes allowed) and sustained limits (longer-term average).
EndpointBurst LimitSustained Limit
POST /order3,500 req / 10s36,000 req / 10 min
DELETE /order3,000 req / 10s30,000 req / 10 min
POST /orders1,000 req / 10s15,000 req / 10 min
DELETE /orders1,000 req / 10s15,000 req / 10 min
DELETE /cancel-all250 req / 10s6,000 req / 10 min
DELETE /cancel-market-orders1,000 req / 10s1,500 req / 10 min

Other

EndpointLimit
Relayer /submit25 req / 1 min
User PNL API200 req / 10s

Next Steps

Authentication

Learn how to authenticate trading requests.

Clients & SDKs

Official TypeScript, Python, and Rust libraries.