127 lines
4.0 KiB
Markdown
127 lines
4.0 KiB
Markdown
> ## 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.
|
|
|
|
# Rate Limits
|
|
|
|
> API rate limits for all Polymarket endpoints
|
|
|
|
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
|
|
|
|
| Endpoint | Limit |
|
|
| --------------------- | ---------------- |
|
|
| General rate limiting | 15,000 req / 10s |
|
|
| Health check (`/ok`) | 100 req / 10s |
|
|
|
|
***
|
|
|
|
## Gamma API
|
|
|
|
Base URL: `https://gamma-api.polymarket.com`
|
|
|
|
| Endpoint | Limit |
|
|
| ------------------------------ | --------------- |
|
|
| General | 4,000 req / 10s |
|
|
| `/events` | 500 req / 10s |
|
|
| `/markets` | 300 req / 10s |
|
|
| `/markets` + `/events` listing | 900 req / 10s |
|
|
| `/comments` | 200 req / 10s |
|
|
| `/tags` | 200 req / 10s |
|
|
| `/public-search` | 350 req / 10s |
|
|
|
|
***
|
|
|
|
## Data API
|
|
|
|
Base URL: `https://data-api.polymarket.com`
|
|
|
|
| Endpoint | Limit |
|
|
| -------------------- | --------------- |
|
|
| General | 1,000 req / 10s |
|
|
| `/trades` | 200 req / 10s |
|
|
| `/positions` | 150 req / 10s |
|
|
| `/closed-positions` | 150 req / 10s |
|
|
| Health check (`/ok`) | 100 req / 10s |
|
|
|
|
***
|
|
|
|
## CLOB API
|
|
|
|
Base URL: `https://clob.polymarket.com`
|
|
|
|
### General
|
|
|
|
| Endpoint | Limit |
|
|
| -------------------------- | --------------- |
|
|
| General | 9,000 req / 10s |
|
|
| `GET` balance allowance | 200 req / 10s |
|
|
| `UPDATE` balance allowance | 50 req / 10s |
|
|
|
|
### Market Data
|
|
|
|
| Endpoint | Limit |
|
|
| ----------------- | --------------- |
|
|
| `/book` | 1,500 req / 10s |
|
|
| `/books` | 500 req / 10s |
|
|
| `/price` | 1,500 req / 10s |
|
|
| `/prices` | 500 req / 10s |
|
|
| `/midpoint` | 1,500 req / 10s |
|
|
| `/midpoints` | 500 req / 10s |
|
|
| `/prices-history` | 1,000 req / 10s |
|
|
| Market tick size | 200 req / 10s |
|
|
|
|
### Ledger
|
|
|
|
| Endpoint | Limit |
|
|
| ------------------------------------------------ | ------------- |
|
|
| `/trades`, `/orders`, `/notifications`, `/order` | 900 req / 10s |
|
|
| `/data/orders` | 500 req / 10s |
|
|
| `/data/trades` | 500 req / 10s |
|
|
| `/notifications` | 125 req / 10s |
|
|
|
|
### Authentication
|
|
|
|
| Endpoint | Limit |
|
|
| ----------------- | ------------- |
|
|
| API key endpoints | 100 req / 10s |
|
|
|
|
### Trading
|
|
|
|
Trading endpoints have both **burst** limits (short spikes allowed) and **sustained** limits (longer-term average).
|
|
|
|
| Endpoint | Burst Limit | Sustained Limit |
|
|
| ------------------------------ | --------------- | ------------------- |
|
|
| `POST /order` | 3,500 req / 10s | 36,000 req / 10 min |
|
|
| `DELETE /order` | 3,000 req / 10s | 30,000 req / 10 min |
|
|
| `POST /orders` | 1,000 req / 10s | 15,000 req / 10 min |
|
|
| `DELETE /orders` | 1,000 req / 10s | 15,000 req / 10 min |
|
|
| `DELETE /cancel-all` | 250 req / 10s | 6,000 req / 10 min |
|
|
| `DELETE /cancel-market-orders` | 1,000 req / 10s | 1,500 req / 10 min |
|
|
|
|
***
|
|
|
|
## Other
|
|
|
|
| Endpoint | Limit |
|
|
| ----------------- | -------------- |
|
|
| Relayer `/submit` | 25 req / 1 min |
|
|
| User PNL API | 200 req / 10s |
|
|
|
|
***
|
|
|
|
## Next Steps
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Authentication" icon="key" href="/api-reference/authentication">
|
|
Learn how to authenticate trading requests.
|
|
</Card>
|
|
|
|
<Card title="Clients & SDKs" icon="cube" href="/api-reference/clients-sdks">
|
|
Official TypeScript, Python, and Rust libraries.
|
|
</Card>
|
|
</CardGroup>
|