polysqueeze 0.1.5

Rust SDK for authenticated access to Polymarket's CLOB, Gamma, and WebSocket APIs.
Documentation
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"],
  "type": "USER" | "MARKET"
}

5. RTDS (Real-Time Data Socket)
Base URL: wss://ws-live-data.polymarket.com

Subscription:

{
  "action": "subscribe",
  "subscriptions": [{
    "topic": "comments",
    "type": "comment_created"
  }]
}