Polymarket API

Real-time Polymarket data through the Codex API: market prices, outcome probabilities, trading volume, events, and trader analytics.

Polymarket is the world’s largest decentralized prediction market platform, built on Polygon. Codex indexes all Polymarket markets, events, trades, and trader activity, providing comprehensive access to market data, outcome prices, trading volumes, and real-time event streams through a unified GraphQL API.

At least for the time being, these endpoints require a Growth or Enterprise plan. Learn more.

​

Platform Information

Property	Value
Platform	Polymarket
Network	Polygon
Chain ID	137
Protocol Filter	POLYMARKET
Status	Live

​

Why Use Codex Over the Polymarket API Directly?

	Codex API	Polymarket API
Rate Limits	1,000+ req/s	~30 req/s
Ranking signals	Sort events or markets by trending score, volume, liquidity, open interest, trades, unique traders, or % change of any of these at 5m / 1h / 4h / 12h / 24h / 1w	Gamma /events order parameter only accepts volume_24hr, volume, liquidity, start_date, end_date, competitive, closed_time. No sub-day windows, no momentum or trending score
Time-windowed stats	Volume, trades, unique traders, liquidity, open interest, and % change for each at 5m / 1h / 4h / 12h / 24h / 1w	Volume only, at 24h / 1wk / 1mo / 1yr. No trade counts, no unique-trader counts, no time-windowed liquidity or OI change
Filtering	Filter events and markets on every stat above (volume, OI, liquidity, trade count, unique traders, % changes, trending score, market count) plus categories, dates, status, protocol	active, closed, archived, liquidity_min/max, volume_min/max, start_date_min/max, end_date_min/max, tag
Cross-venue	One query, one schema, one ranking system covering Polymarket and Kalshi (plus future venues)	Polymarket only. Integrating Kalshi means a second vendor, second auth, second schema

​

Understanding Events and Markets

Events are collections of related markets. For example:

• Event: “Champions League Final 2026”
  • Market 1: “Will Team A win?”
  • Market 2: “Will the score be over 2.5 goals?”
  • Market 3: “Will there be a penalty?”

Use filterPredictionEvents to find trending high-level topics. Use filterPredictionMarkets to find trending markets.

​

ID Formats

Polymarket uses specific ID formats to uniquely identify markets, events, and traders across the platform:

​

Market ID

Format: <marketAddress>:Polymarket:<exchangeAddress>:<networkId>

Example: 0x25aa90b3cd98305e849189b4e8b770fc77fe89bccb7cf9656468414e01145d38:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137

• marketAddress: The unique contract address for this specific market outcome
• Polymarket: The protocol identifier
• exchangeAddress: The Polymarket exchange contract address. Two appear in IDs: the CTF exchange 0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e (most markets) and the NegRisk exchange 0xc5d563a36ae78145c45a50134d48a1215220f80a. Copy IDs from query results rather than building them by hand. On trades, exchangeTradedOnAddress shows the exchange the trade actually went through, which can differ when a market moved to a newer exchange.
• networkId: The blockchain network ID (137 for Polygon)

​

Event ID

Format: <eventSlug>:Polymarket:<exchangeAddress>:<networkId>

Example: 67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137

• eventSlug: The Polymarket event identifier (venue ID)
• Polymarket: The protocol identifier
• exchangeAddress: The Polymarket exchange contract address
• networkId: The blockchain network ID (137 for Polygon)

​

Trader ID

Format: <address>:Polymarket

Example: 0x742d35cc6634c0532925a3b844bc9e7595f0beb6:Polymarket

• address: The trader’s wallet address
• Polymarket: The protocol identifier

​

Supported APIs

​

Market & Event API

• Filter Prediction Events — Query Polymarket events with advanced filtering
• Filter Prediction Markets — Search and filter Polymarket markets by volume, liquidity, category, and other criteria
• Get Detailed Event Stats — Fetch detailed statistics for Polymarket events
• Get Detailed Market Stats — Retrieve comprehensive trading metrics for any Polymarket market
• Get Event Price Bars — Retrieve event-level price history for charting
• Get Market Price Bars — Fetch OHLC price data for Polymarket markets

​

Trading & Activity API

• Get Prediction Trades — Query trade history and trading activity on Polymarket
• Get Trader Stats — Retrieve comprehensive trader performance metrics
• Filter Traders — Discover top Polymarket traders by volume, PnL, win rate, and other metrics
• Get Trader Market Stats — Analyze trader performance across specific markets
• Get Trader Bars — Track trader activity over time with time-series data
• Filter Trader Markets — Query markets a specific trader has participated in

​

Market Discovery API

• Get Prediction Categories — Browse Polymarket categories (Politics, Crypto, Sports, etc.)
• Get Token Holders — Query outcome token holders and current positions

​

Example Queries

​

Find Trending Polymarket Events

{
  filterPredictionEvents(
    filters: {
      protocol: POLYMARKET
      status: OPEN
    }
    rankings: [{ attribute: trendingScore24h, direction: DESC }]
    limit: 10
  ) {
    count
    results {
      event {
        question
        description
      }
      marketCount
      volumeUsd24h
      trendingScore24h
    }
  }
}

​

Find Top Polymarket Markets by 24h Volume

{
  filterPredictionMarkets(
    filters: {
      protocol: POLYMARKET
      status: OPEN
    }
    rankings: [{ attribute: volumeUsd24h, direction: DESC }]
    limit: 10
  ) {
    count
    results {
      id
      eventLabel
      protocol
      market {
        question
        label
        status
        protocol
        networkId
      }
      volumeUsd24h
      liquidityUsd
      trades24h
      uniqueTraders24h
      outcome0 {
        label
        lastPriceUsd
      }
      outcome1 {
        label
        lastPriceUsd
      }
    }
  }
}

​

Find Polymarket Markets in Politics Category

{
  filterPredictionMarkets(
    filters: {
      protocol: POLYMARKET
      status: OPEN
      categories: ["politics"]
    }
    rankings: [{ attribute: volumeUsd24h, direction: DESC }]
    limit: 20
  ) {
    count
    results {
      id
      eventLabel
      market {
        question
      }
      categories
      volumeUsd24h
      liquidityUsd
      outcome0 {
        label
        lastPriceUsd
      }
      outcome1 {
        label
        lastPriceUsd
      }
    }
  }
}

​

Find Top Polymarket Traders

{
  filterPredictionTraders(
    filters: { protocol: POLYMARKET }
    rankings: [{ attribute: TOTAL_VOLUME_USD_ALL, direction: DESC }]
    limit: 50
  ) {
    count
    results {
      trader {
        primaryAddress
        alias
      }
      totalVolumeUsdAll
      totalProfitUsdAll
      totalTradesAll
      activeMarketsCount
      winRate24h
      realizedPnlUsd24h
    }
  }
}

​

Get Price History for a Market

{
  predictionMarketBars(
    input: {
      marketId: "0x25aa90b3cd98305e849189b4e8b770fc77fe89bccb7cf9656468414e01145d38:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137"
      resolution: hour1
      from: 1772665600
      to: 1773270400
    }
  ) {
    marketId
    bars {
      t
      volumeUsd
      trades
      uniqueTraders
      outcome0 {
        priceUsd {
          o
          h
          l
          c
        }
      }
      outcome1 {
        priceUsd {
          o
          h
          l
          c
        }
      }
    }
  }
}

​

Try It in the Explorer

Test any Polymarket query directly in the Codex GraphQL Explorer.

​

Recipes

Step-by-step guides for building with Polymarket data:

Discover Prediction Markets

Browse categories, trending events, and filter markets.

Prediction Traders

Trader leaderboards, profiles, and performance analytics.

Prediction Charts

Outcome probability charts, multi-market comparisons, and OHLC data.

Prediction Event Dashboard

Build a complete event detail page with real-time data.

​

Related Resources

• Supported Prediction Markets Overview — All supported platforms
• Supported Networks Overview — All supported blockchain networks