onDetailedPredictionEventStatsUpdated - Codex

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

Show Properties

eventId

String!

The ID of the prediction event.

lastTransactionAt

Int!

The timestamp of the last transaction.

lifecycle

PredictionLifecycleStats!

Lifecycle metadata. See PredictionLifecycleStats

statsMin5

EnhancedWindowedPredictionEventStats

Stats for the 5-minute window. See EnhancedWindowedPredictionEventStats

statsHour1

EnhancedWindowedPredictionEventStats

Stats for the 1-hour window. See EnhancedWindowedPredictionEventStats

statsHour4

EnhancedWindowedPredictionEventStats

Stats for the 4-hour window. See EnhancedWindowedPredictionEventStats

statsHour12

EnhancedWindowedPredictionEventStats

Stats for the 12-hour window. See EnhancedWindowedPredictionEventStats

statsDay1

EnhancedWindowedPredictionEventStats

Stats for the 1-day window. See EnhancedWindowedPredictionEventStats

statsWeek1

EnhancedWindowedPredictionEventStats

Stats for the 1-week window. See EnhancedWindowedPredictionEventStats

Trending scores across time windows. See DetailedPredictionStatsScores

relevanceScores

DetailedPredictionStatsScores!

Relevance scores across time windows. See DetailedPredictionStatsScores

allTimeStats

PredictionEventAllTimeStats!

All-time aggregate stats. See PredictionEventAllTimeStats

Arguments

eventId

String!

required

The ID of the prediction event.

Subscription example

Test this query in the Explorer →

subscription {
  onDetailedPredictionEventStatsUpdated(eventId: "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137") {
    lastTransactionAt
    lifecycle {
      ageSeconds
      expectedLifespanSeconds
      timeToResolutionSeconds
      isResolved
      winningOutcomeId
    }
    statsMin5 {
      start
      end
      lastTransactionAt
      core {
        volume {
          usd
          ct
        }
        trades
      }
      buySell {
        buyVolume {
          usd
        }
        sellVolume {
          usd
        }
      }
      uniqueTraders {
        uniqueTraders
      }
      openInterest {
        openInterest {
          open {
            usd
          }
          close {
            usd
          }
        }
      }
      liquidity {
        liquidity {
          open {
            usd
          }
          close {
            usd
          }
        }
      }
      statsChange {
        volumeChange
        buyVolumeChange
        sellVolumeChange
        tradesChange
        uniqueTradersChange
      }
      scores {
        trending
        relevance
      }
    }
    statsHour1 {
      core {
        volume {
          usd
        }
        trades
      }
      buySell {
        buyVolume {
          usd
        }
        sellVolume {
          usd
        }
      }
      uniqueTraders {
        uniqueTraders
      }
    }
    statsDay1 {
      core {
        volume {
          usd
        }
        trades
      }
    }
    allTimeStats {
      volume {
        usd
        ct
      }
      venueVolume {
        usd
      }
    }
  }
}

Example Response

{
  "data": {
    "onDetailedPredictionEventStatsUpdated": {
      "lastTransactionAt": 1773357223,
      "lifecycle": {
        "ageSeconds": 11592546,
        "expectedLifespanSeconds": 12027321,
        "timeToResolutionSeconds": 434775,
        "isResolved": false,
        "winningOutcomeId": null
      },
      "statsMin5": {
        "start": 1773356880,
        "end": 1773357240,
        "lastTransactionAt": 1773357223,
        "core": {
          "volume": { "usd": "10297", "ct": "10298" },
          "trades": 25
        },
        "buySell": {
          "buyVolume": { "usd": "9339" },
          "sellVolume": { "usd": "958" }
        },
        "uniqueTraders": {
          "uniqueTraders": 8
        },
        "openInterest": {
          "openInterest": {
            "open": { "usd": "34058066" },
            "close": { "usd": "34058066" }
          }
        },
        "liquidity": {
          "liquidity": {
            "open": { "usd": "40568513" },
            "close": { "usd": "40571490" }
          }
        },
        "statsChange": {
          "volumeChange": -0.3347331696601628,
          "buyVolumeChange": -0.3906831082403601,
          "sellVolumeChange": 5.344370860927152,
          "tradesChange": -0.2647058823529412,
          "uniqueTradersChange": -0.5294117647058824
        },
        "scores": {
          "trending": 0.31540938802070095,
          "relevance": 0.8392556393431304
        }
      },
      "statsHour1": {
        "core": {
          "volume": { "usd": "38025" },
          "trades": 310
        },
        "buySell": {
          "buyVolume": { "usd": "28468" },
          "sellVolume": { "usd": "9556" }
        },
        "uniqueTraders": {
          "uniqueTraders": 81
        }
      },
      "statsDay1": {
        "core": {
          "volume": { "usd": "8622225" },
          "trades": 17230
        }
      },
      "allTimeStats": {
        "volume": { "usd": "183695543", "ct": "184322079" },
        "venueVolume": { "usd": "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

What time windows are available?

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.

What's the difference between volumeUsd and volumeCT?

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.

Why are some fields null or zero?

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).

Market Chart UpdatesLive-streamed bar chart data to track price changes over time for a prediction market.

⌘I