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.
This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
DetailedSubscriptionPredictionEventStats
DetailedSubscriptionPredictionEventStats
See DetailedSubscriptionPredictionEventStats

​
Arguments

​
eventId
String!
required
The ID of the prediction event.

​
Subscription example

subscription {
  onDetailedPredictionEventStatsUpdated(eventId: "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137") {
    lastTransactionAt
    lifecycle {
      ageSeconds
      expectedLifespanSeconds
      timeToResolutionSeconds
      isResolved
      winningOutcomeId
    }
    statsMin5 {
      start
      end
      lastTransactionAt
      statsCurrency {
        volumeUsd
        buyVolumeUsd
        sellVolumeUsd
        volumeCT
        openOpenInterestUsd
        closeOpenInterestUsd
        openLiquidityUsd
        closeLiquidityUsd
      }
      statsNonCurrency {
        trades
        uniqueTraders
      }
      statsChange {
        volumeChange
        buyVolumeChange
        sellVolumeChange
        tradesChange
        uniqueTradersChange
      }
      scores {
        trending
        relevance
      }
      allTimeStats {
        volumeUsd
        volumeCT
        venueVolumeUsd
      }
    }
    statsHour1 {
      statsCurrency {
        volumeUsd
        buyVolumeUsd
        sellVolumeUsd
      }
      statsNonCurrency {
        trades
        uniqueTraders
      }
    }
    statsDay1 {
      statsCurrency {
        volumeUsd
      }
      statsNonCurrency {
        trades
      }
    }
    allTimeStats {
      volumeUsd
      volumeCT
      venueVolumeUsd
    }
  }
}
Example Response
{
  "data": {
    "onDetailedPredictionEventStatsUpdated": {
      "lastTransactionAt": 1773357223,
      "lifecycle": {
        "ageSeconds": 11592546,
        "expectedLifespanSeconds": 12027321,
        "timeToResolutionSeconds": 434775,
        "isResolved": false,
        "winningOutcomeId": null
      },
      "statsMin5": {
        "start": 1773356880,
        "end": 1773357240,
        "lastTransactionAt": 1773357223,
        "statsCurrency": {
          "volumeUsd": "10297",
          "buyVolumeUsd": "9339",
          "sellVolumeUsd": "958",
          "volumeCT": "10298",
          "openOpenInterestUsd": "34058066",
          "closeOpenInterestUsd": "34058066",
          "openLiquidityUsd": "40568513",
          "closeLiquidityUsd": "40571490"
        },
        "statsNonCurrency": {
          "trades": 25,
          "uniqueTraders": 8
        },
        "statsChange": {
          "volumeChange": -0.3347331696601628,
          "buyVolumeChange": -0.3906831082403601,
          "sellVolumeChange": 5.344370860927152,
          "tradesChange": -0.2647058823529412,
          "uniqueTradersChange": -0.5294117647058824
        },
        "scores": {
          "trending": 0.31540938802070095,
          "relevance": 0.8392556393431304
        },
        "allTimeStats": {
          "volumeUsd": "183695543",
          "volumeCT": "184322079",
          "venueVolumeUsd": "350591805"
        }
      },
      "statsHour1": {
        "statsCurrency": {
          "volumeUsd": "38025",
          "buyVolumeUsd": "28468",
          "sellVolumeUsd": "9556"
        },
        "statsNonCurrency": {
          "trades": 310,
          "uniqueTraders": 81
        }
      },
      "statsDay1": {
        "statsCurrency": {
          "volumeUsd": "8622225"
        },
        "statsNonCurrency": {
          "trades": 17230
        }
      },
      "allTimeStats": {
        "volumeUsd": "183695543",
        "volumeCT": "184322079",
        "venueVolumeUsd": "350591805"
      }
    }
  }
}

​
Usage Guidelines

  • Event ID format varies by platform:
    • Polymarket: <eventSlug>:Polymarket:<exchangeAddress>:<networkId> (e.g., 67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137)
    • Kalshi: <eventSlug>:Kalshi (e.g., KXMVESPORTSMULTIGAMEEXTENDED-S2026350C4EF9BCE:Kalshi)
  • Subscribe using the eventId to track real-time stats for a specific prediction event
  • Stats are provided across multiple time windows: 5-minute, 1-hour, 4-hour, 12-hour, 1-day, and 1-week
  • Updates stream in real-time whenever a new trade occurs on the prediction event

​
Troubleshooting Tips

Stats are available for 6 time windows: statsMin5 (5 minutes), statsHour1 (1 hour), statsHour4 (4 hours), statsHour12 (12 hours), statsDay1 (1 day), and statsWeek1 (1 week). Each window provides granular metrics for that time period.
volumeUsd is the trading volume denominated in US dollars, while volumeCT is volume in collateral token units. For Polymarket (which uses USDC as collateral), these values are typically the same. For other protocols, they may differ based on the collateral token’s USD price.
Fields may be null if the data isn’t available for older events or if the event hasn’t had activity in a particular time window. winningOutcomeId is null until the event is resolved. Zero values indicate no activity in that category (e.g., no sells during a time window).