Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.codex.io/llms.txt

Use this file to discover all available pages before exploring further.

Prediction Market data is currently in beta. It is actively being worked on and improved, but may be unreliable. Polymarket and Kalshi data are live.At least for the time being, this endpoint requires a Growth or Enterprise plan. Learn more.
This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
DetailedPredictionEventStats
DetailedPredictionEventStats
See DetailedPredictionEventStats

​
Arguments

​
input
DetailedPredictionEventStatsInput!
required
Input parameters used to select an event and stat windows. See DetailedPredictionEventStatsInput

​
Example: Get detailed stats for a specific event

{
  detailedPredictionEventStats(
    input: {
      eventId: "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137"
    }
  ) {
    eventId
    predictionEvent {
      protocol
      question
      closesAt
      resolvedAt
      createdAt
    }
    statsHour1 {
      core {
        volume {
          usd
        }
      }
      uniqueTraders {
        uniqueTraders
      }
    }
    statsHour4 {
      core {
        volume {
          usd
        }
      }
    }
    statsDay1 {
      core {
        volume {
          usd
        }
      }
      liquidity {
        liquidity {
          close {
            usd
          }
        }
      }
      uniqueTraders {
        uniqueTraders
      }
    }
    allTimeStats {
      volume {
        usd
      }
    }
  }
}
Example Response
{
  "data": {
    "detailedPredictionEventStats": {
      "eventId": "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137",
      "predictionEvent": {
        "protocol": "POLYMARKET",
        "question": "Fed decision in March?",
        "closesAt": 1773792000,
        "resolvedAt": null,
        "createdAt": 1768590204
      },
      "statsHour1": {
        "core": {
          "volume": {
            "usd": "7124"
          }
        },
        "uniqueTraders": {
          "uniqueTraders": 62
        }
      },
      "statsHour4": {
        "core": {
          "volume": {
            "usd": "2835595"
          }
        }
      },
      "statsDay1": {
        "core": {
          "volume": {
            "usd": "15371853"
          }
        },
        "liquidity": {
          "liquidity": {
            "close": {
              "usd": "32228389"
            }
          }
        },
        "uniqueTraders": {
          "uniqueTraders": 2553
        }
      },
      "allTimeStats": {
        "volume": {
          "usd": "175071520"
        }
      }
    }
  }
}

​
Usage Guidelines

  • The eventId format varies by platform:
    • Polymarket: <eventSlug>:Polymarket:<exchangeAddress>:<networkId> (e.g., 67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137)
    • Kalshi: <eventSlug>:Kalshi (e.g., KXMVESPORTSMULTIGAMEEXTENDED-S2026350C4EF9BCE:Kalshi)
  • Query only the time windows you need (statsMin5, statsHour1, statsHour4, etc.) to reduce response size
  • Event stats aggregate data from all markets within the event - use detailedPredictionMarketStats for individual market analysis
  • Each windowed stat includes core (volume, trades), uniqueTraders, liquidity, openInterest, statsChange (percentage changes vs previous window), scores, and allTimeStats (aggregate snapshot at window end)
  • Use filterPredictionEvents to find eventIds - you can’t query this endpoint without one
  • For real-time updates, use the onDetailedPredictionEventStatsUpdated subscription

​
Understanding Scores

Each time window includes three scores that help rank and filter events:
  • trending - Measures what’s “heating up” - prioritizes growth velocity over absolute size (a small event with 10x volume growth scores higher than a large event with flat volume)
  • relevance - Measures what “matters” - based on absolute size and capital at stake, with no growth multipliers (large, established events rank high even if quiet)
  • competitive - Measures genuine uncertainty - higher when prices are near 50%, trading is balanced on both sides, and there’s active price discovery

​
Troubleshooting Tips

Events can contain multiple markets. Event stats aggregate all volume, traders, and liquidity across those markets. Use detailedPredictionMarketStats for stats on a specific market within an event.
Use filterPredictionEvents to search for events, or get the eventId from any market query.
Use predictionEventBars for OHLC bars over time. This query only returns current windowed snapshots.