API Reference

Integrate with Polymarket's Central Limit Order Book (CLOB)

Polymarket CLOB API

Polymarket uses a Central Limit Order Book (CLOB) for order matching. Your PolymarketVPS is located in Dublin for ultra-low latency (0-2ms) to the CLOB endpoint.

Base URL

https://clob.polymarket.com

Authentication

The CLOB API uses API keys for authentication. You can generate keys from your Polymarket account settings.

Python Client (py-clob-client)

The recommended way to interact with the CLOB:

from py_clob_client import ClobClient

client = ClobClient(
    host="https://clob.polymarket.com",
    key=YOUR_API_KEY,
    chain_id=137  # Polygon
)

# Get order book
order_book = client.get_order_book(token_id)

# Place limit order
order = client.create_limit_order(
    token_id=token_id,
    price=0.65,
    size=100,
    side="BUY"
)

WebSocket Streams

For real-time market data, connect to the WebSocket endpoint:

wss://ws-subscriptions-clob.polymarket.com/ws/market

Rate Limits

  • REST API: 100 requests per second
  • WebSocket: Unlimited subscriptions
  • Order placement: 10 orders per second

Latency from PolymarketVPS

Our Dublin servers provide ultra-low round-trip latency to the CLOB. Typical ping times are 0.8-1.5ms.

Official Documentation

For complete API documentation, visit the official Polymarket docs.

docs.polymarket.com