Polymarket website screenshot

Polymarket

Polymarket is a decentralized prediction-market platform built on Polygon where users buy and sell binary outcome shares in real-world events. Settlement is on-chain via the UMA optimistic oracle, while order matching runs through a hybrid central-limit order book (CLOB). Developer surface includes the CLOB API for order placement and market data, the Gamma API for market and event metadata, a Data API for historical and analytical reads, a WebSocket stream, and official CLOB client SDKs in TypeScript, Python, and Rust.

7 APIs 0 Features
Prediction MarketsDeFiPolygonOrder BookCryptoMarkets

APIs

Polymarket CLOB API

Central-limit order book REST API for Polymarket - place, cancel, and query orders, list markets and tokens, fetch order books and trades, and look up user positions. Used by tr...

Polymarket Gamma API

Read-only metadata API for markets, events, tags, and categories - the surface that powers polymarket.com's listings and search. Useful for discovery and for stitching multiple ...

Polymarket Data API

Historical and analytical data API exposing trades, prices, volumes, holders, and time-series aggregates across Polymarket markets, intended for research, dashboards, and quanti...

Polymarket WebSocket

Real-time streaming feed for order book updates, trades, and market events on the Polymarket CLOB - used by trading clients to maintain a live view of the book without polling.

py-clob-client (Python SDK)

Official Python SDK for the Polymarket CLOB API - wallet signing, EIP-712 order construction, place / cancel / query, and market data helpers.

clob-client (TypeScript SDK)

Official TypeScript / JavaScript SDK for the Polymarket CLOB API - typed clients, wallet integration (viem), order construction, and market data helpers.

clob-client (Rust SDK)

Official Rust SDK for the Polymarket CLOB API.

Collections

Polymarket APIs (CLOB and Gamma)

OPEN

Pricing Plans

Polymarket Plans Pricing

1 plans

PLANS

Rate Limits

Polymarket Rate Limits

2 limits

RATE LIMITS

FinOps

Polymarket Finops

FINOPS

Event Specifications

Polymarket CLOB WebSocket API

Real-time streaming feed for Polymarket's central-limit order book (CLOB). Two channels are exposed: a public market channel that streams order book snapshots, price level updat...

ASYNCAPI

Resources

🔗
Website
Website
🔗
Documentation
Documentation
🔗
US Documentation
US Documentation
👥
GitHub
GitHub
🔗
Builders Program
Builders Program
💬
Support
Support
🟢
Status
Status
🔗
LinkedIn
LinkedIn
🔗
LlmsText
LlmsText

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Polymarket APIs (CLOB and Gamma)
  version: '1.0'
items:
- info:
    name: CLOB Trade
    type: folder
  items:
  - info:
      name: Post a new order
      type: http
    http:
      method: POST
      url: https://clob.polymarket.com/order
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: POLY_API_KEY
        value: '{{POLY_API_KEY}}'
        placement: header
    docs: 'Submit a new signed order to the Polymarket CLOB.

      Requires the full POLY_* signed-request header set.

      '
- info:
    name: CLOB Market Data
    type: folder
  items:
  - info:
      name: Get midpoint price for a market
      type: http
    http:
      method: GET
      url: https://clob.polymarket.com/midpoint
      params:
      - name: token_id
        value: ''
        type: query
    docs: Returns the average of the best bid and best ask prices for the given token.
  - info:
      name: Get server time
      type: http
    http:
      method: GET
      url: https://clob.polymarket.com/time
    docs: Returns the current Unix timestamp of the CLOB server.
- info:
    name: Gamma Markets
    type: folder
  items:
  - info:
      name: Get market by id
      type: http
    http:
      method: GET
      url: https://clob.polymarket.com/markets/:id
      params:
      - name: id
        value: ''
        type: path
      - name: include_tag
        value: ''
        type: query
    docs: Returns a single market by its numeric identifier.
- info:
    name: Gamma Events
    type: folder
  items:
  - info:
      name: List events
      type: http
    http:
      method: GET
      url: https://clob.polymarket.com/events
      params:
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
      - name: order
        value: ''
        type: query
        description: Comma-separated field list to sort by.
      - name: ascending
        value: ''
        type: query
      - name: id
        value: ''
        type: query
      - name: tag_id
        value: ''
        type: query
      - name: slug
        value: ''
        type: query
      - name: active
        value: ''
        type: query
      - name: archived
        value: ''
        type: query
      - name: featured
        value: ''
        type: query
      - name: closed
        value: ''
        type: query
      - name: liquidity_min
        value: ''
        type: query
      - name: liquidity_max
        value: ''
        type: query
      - name: volume_min
        value: ''
        type: query
      - name: volume_max
        value: ''
        type: query
      - name: start_date_min
        value: ''
        type: query
      - name: start_date_max
        value: ''
        type: query
      - name: end_date_min
        value: ''
        type: query
      - name: end_date_max
        value: ''
        type: query
    docs: Returns an array of event objects. Supports filtering and pagination.
bundled: true