Base URLs
| API | Base URL | Use for |
|---|---|---|
| Gamma | https://gamma-api.polymarket.com | Markets, events, metadata |
| CLOB | https://clob.polymarket.com | Order book, prices, orders |
| Data API v2 | https://data-api.polymarket.com | Positions, trades, activity |
| Bridge | https://bridge.polymarket.com | Deposits/withdrawals, supported assets |
| Relayer | https://relayer-v2.polymarket.com | Gasless transactions |
Rate limits
| Scope | Limit |
|---|---|
| General | 15,000 / 10s |
| Gamma | 4,000 / 10s |
| Data API v2 | 800 / 10s |
| CLOB /book, /price, /midpoint | 1,500 / 10s each |
| POST /order | 5,000 / 10s burst · 120,000 / 10 min |
| Bridge | 50 / 10s |
| Relayer /submit | 25 / min |
Order and cancel requests also have per-signer limits. Source: rate limits, checked 14 Nov 2026.
Building a bot?
You need a funded polymarket.com account to trade through the CLOB.
Recent changes
- 2 Nov 2026 — Data API v1 retired.
- 11 Nov 2026 — Relayer only relays transactions that interact with Polymarket contracts (plus a short third-party list).
- 14 Dec 2026 — CLOB:
associate_tradesdeprecated;asset_idfilter on/data/ordersrequiresmarket;asset_id/token_idfilters removed from/ordersand/v1/trade/open-orders. - 12 Nov 2026 — the old Python CLOB client is deprecated;
py-clob-client-v2adds Protocol V2 order signing (Amoy testnet). - PolyBolt WebSocket (since Sep 2026) for real-time prices; RTDS is legacy for reference prices.
Source: changelog.
Auth in two lines
- L1: sign an EIP-712 message with your wallet to create or recover API credentials. Keys stay local.
- L2: sign each request with HMAC-SHA256 using the API key, secret and passphrase (POLY_* headers). Orders are also wallet-signed.
FAQ
Does the Polymarket API need a key?
Not for public market data (Gamma, CLOB prices/books, Data API). Trading needs L2 API credentials created with a wallet signature.
Is the API geoblocked?
Yes, trading follows the same location rules. Check GET https://polymarket.com/api/geoblock before showing trading features. Ireland, Japan, Malta, Netherlands and South Korea are restricted on the website only, not the API.
What happened to Data API v1?
Retired on 2 November 2026. Move to v2 (cursor pagination, shared response envelope).
Need an account to trade via API?
Sign up on polymarket.com, deposit, then create API credentials.