Polymarket API Endpoints Reference
1. CLOB REST API
Base URL: https://clob.polymarket.com
Authentication Headers
L1 Header (Private Key Auth):
POLY_ADDRESS - Polygon address
POLY_SIGNATURE - CLOB EIP 712 signature
POLY_TIMESTAMP - Current UNIX timestamp
POLY_NONCE - Nonce (default 0)
L2 Header (API Key Auth):
POLY_ADDRESS - Polygon address
POLY_SIGNATURE - HMAC signature for request
POLY_TIMESTAMP - Current UNIX timestamp
POLY_API_KEY - Polymarket API key
POLY_PASSPHRASE - API key passphrase
Endpoints
POST /auth/api-key (L1 Header)
Creates API key credentials
GET /auth/derive-api-key (L1 Header)
Derives existing API key
GET /auth/api-keys (L2 Header)
Retrieves all API keys
DELETE /auth/api-key (L2 Header)
Deletes API key
POST /order (L2 Header)
Places single order
Body: {order, owner, orderType}
POST /orders (L2 Header)
Places up to 15 orders (batch)
Body: Array of {order, owner, orderType}
GET /data/orders (L2 Header)
Query: id, market, asset_id
Returns: OpenOrder[]
GET /data/order/{order_hash} (L2 Header)
Returns: Single OpenOrder
GET /data/trades (L2 Header)
Query: id, taker, maker, market, before, after
Returns: Trade[]
Rate Limits: See documentation - varies by endpoint (50-5000 req/10s)
2. Data API
Base URL: https://data-api.polymarket.com
Rate Limit: 200 requests/10s (general)
Used for user data, holdings, and on-chain activities. Specific endpoints not detailed in search results.
3. Gamma API
Base URL: https://gamma-api.polymarket.com
Rate Limit: 125 requests/10s for /markets
Endpoints
GET /markets
Query: limit, offset, closed, tag_id, exclude_tag_id, related_tags, order, ascending
Returns: Market metadata array
GET /markets/slug/{slug}
Returns: Single market by slug
GET /events
Query: limit, offset, closed, tag_id, order, ascending
Returns: Events with associated markets
GET /events/slug/{slug}
Returns: Single event by slug
GET /tags
Returns: Available tags for filtering
GET /sports
Returns: Sports metadata with tag IDs
4. CLOB WebSocket
Base URL: wss://ws-subscriptions-clob.polymarket.com/ws/
Subscription Message:
{
"auth": {...},
"markets": ["condition_id"],
"assets_ids": ["token_id"],
5. RTDS (Real-Time Data Socket)
Base URL: wss://ws-live-data.polymarket.com
Subscription:
{
"action": "subscribe",
"subscriptions": [{
"topic": "comments",
"type": "comment_created"
}]
}