Update Polymarket documentation (2026-02-19)

- Added new documentation URLs from llms.txt index - Updated TARGET.md with 244 total documentation pages - Scraped new pages for trading, concepts, and API reference sections - Updated changelog and new index pages
2026-02-19 14:31:02 +01:00
parent 81f77eff3c
commit b2a29fe51f
250 changed files with 33306 additions and 9659 deletions
@@ -0,0 +1,126 @@
+> ## 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>