Skip to main content
Kalshi is the first CFTC-regulated prediction market exchange in the United States, offering event contracts on topics ranging from politics and economics to weather and technology. Codex will index all Kalshi markets, events, trades, and trader activity, providing comprehensive access to market data through a unified GraphQL API.
Kalshi data is coming soon. Prediction Market data is currently in beta and actively being worked on. Polymarket data is live now.At least for the time being, these endpoints require a Growth or Enterprise plan. Learn more.

​
Platform Information

PropertyValue
PlatformKalshi
Protocol FilterKALSHI
StatusComing Soon
TypeRegulated Exchange (CFTC)

​
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

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

​
Market ID

Format: <marketSlug>:Kalshi Example: KXMVECROSSCATEGORY-S2026A4A05B370DF-F1FBA451AA9:Kalshi
  • marketSlug: The Kalshi market identifier (venue market slug)
  • Kalshi: The protocol identifier

​
Event ID

Format: <eventSlug>:Kalshi Example: KXMVESPORTSMULTIGAMEEXTENDED-S2026350C4EF9BCE:Kalshi
  • eventSlug: The Kalshi event identifier (venue event slug)
  • Kalshi: The protocol identifier
Kalshi uses slug-based identifiers rather than blockchain addresses since it operates as a centralized, CFTC-regulated exchange (not on-chain like Polymarket).

​
Kalshi-Specific Limitations

Trader data is not available for Kalshi. Due to privacy considerations on Kalshi’s regulated exchange, individual trader information is not exposed through their API. This means:
  • No traderId filtering is available on any endpoints
  • Trader-specific queries and endpoints cannot be used with Kalshi data
  • Trade data shows aggregate activity but not individual trader identities
  • Trade events show TRADE type only (no distinction between BUY/SELL)

​
Supported APIs (Coming Soon)

​
Market & Event API

​
Trading & Activity API

  • Get Prediction Trades — Query trade history and aggregate trading activity on Kalshi (no individual trader data)

​
Market Discovery API

​
Example Queries (Available Soon)

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

​
Find Top Kalshi Markets by 24h Volume

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

​
Find Kalshi Markets in Economics Category

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

​
Get Price History for a Market

{
  predictionMarketBars(
    input: {
      marketId: "KXMVECROSSCATEGORY-S2026A4A05B370DF-F1FBA451AA9:Kalshi"
      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 Kalshi query directly in the Codex GraphQL Explorer when data becomes available.
Want to be notified when Kalshi data is available? Contact us to get updates.