onDetailedPredictionMarketStatsUpdated - 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

DetailedSubscriptionPredictionMarketStats

See DetailedSubscriptionPredictionMarketStats

Show Properties

String!

The ID of the prediction market.

Int!

The timestamp of the last transaction.

PredictionLifecycleStats!

Lifecycle metadata. See PredictionLifecycleStats

EnhancedWindowedPredictionMarketStats

Stats for the 5-minute window. See EnhancedWindowedPredictionMarketStats

EnhancedWindowedPredictionMarketStats

Stats for the 1-hour window. See EnhancedWindowedPredictionMarketStats

EnhancedWindowedPredictionMarketStats

Stats for the 4-hour window. See EnhancedWindowedPredictionMarketStats

EnhancedWindowedPredictionMarketStats

Stats for the 12-hour window. See EnhancedWindowedPredictionMarketStats

EnhancedWindowedPredictionMarketStats

Stats for the 1-day window. See EnhancedWindowedPredictionMarketStats

EnhancedWindowedPredictionMarketStats

Stats for the 1-week window. See EnhancedWindowedPredictionMarketStats

Trending scores across time windows. See DetailedPredictionStatsScores

DetailedPredictionStatsScores!

Relevance scores across time windows. See DetailedPredictionStatsScores

DetailedPredictionStatsScores!

Competitive scores across time windows. See DetailedPredictionStatsScores

PredictionMarketAllTimeStats!

All-time aggregate stats. See PredictionMarketAllTimeStats

Arguments

String!

required

The ID of the prediction market.

Subscription example

Test this query in the Explorer →

subscription {
  onDetailedPredictionMarketStatsUpdated(
    marketId: "0x25aa90b3cd98305e849189b4e8b770fc77fe89bccb7cf9656468414e01145d38:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137"
  ) {
    lastTransactionAt
    lifecycle {
      ageSeconds
      expectedLifespanSeconds
      timeToResolutionSeconds
      isResolved
      winningOutcomeId
    }
    statsMin5 {
      start
      end
      core {
        volume {
          usd
          ct
        }
        trades
      }
      uniqueTraders {
        uniqueTraders
      }
      openInterest {
        openInterest {
          open {
            usd
          }
          close {
            usd
          }
        }
      }
      statsChange {
        volumeChange
        tradesChange
      }
      scores {
        trending
        relevance
        competitive
      }
    }
    statsHour1 {
      core {
        volume {
          usd
        }
        trades
      }
      uniqueTraders {
        uniqueTraders
      }
    }
    statsDay1 {
      core {
        volume {
          usd
        }
        trades
      }
    }
    trendingScores {
      score5m
      score1
      score4
      score12
      score24
      score1w
    }
    allTimeStats {
      volume {
        usd
        ct
      }
      venueVolume {
        usd
      }
    }
  }
}

Example Response

{
  "data": {
    "onDetailedPredictionMarketStatsUpdated": {
      "lastTransactionAt": 1773356943,
      "lifecycle": {
        "ageSeconds": 11592478,
        "expectedLifespanSeconds": 12027533,
        "timeToResolutionSeconds": 435055,
        "isResolved": false,
        "winningOutcomeId": null
      },
      "statsMin5": {
        "start": 1773356640,
        "end": 1773357000,
        "core": {
          "volume": { "usd": "2441", "ct": "2442" },
          "trades": 4
        },
        "uniqueTraders": {
          "uniqueTraders": 1
        },
        "openInterest": {
          "openInterest": {
            "open": { "usd": "8219750" },
            "close": { "usd": "8219750" }
          }
        },
        "statsChange": {
          "volumeChange": 151.5625,
          "tradesChange": 3
        },
        "scores": {
          "trending": 0.3179737717217025,
          "relevance": 0.7518398963622758,
          "competitive": 0.00028312879456631314
        }
      },
      "statsHour1": {
        "core": {
          "volume": { "usd": "3679" },
          "trades": 485
        },
        "uniqueTraders": {
          "uniqueTraders": 23
        }
      },
      "statsDay1": {
        "core": {
          "volume": { "usd": "2787963" },
          "trades": 4884
        }
      },
      "trendingScores": {
        "score5m": 0.3179737717217025,
        "score1": 0.2784615419805427,
        "score4": 0.38295093043975303,
        "score12": 0.46375984101869644,
        "score24": 0.40366629545667476,
        "score1w": 0.4400265051438401
      },
      "allTimeStats": {
        "volume": { "usd": "71642660", "ct": "71839682" },
        "venueVolume": { "usd": "124698659" }
      }
    }
  }
}

Usage Guidelines

Market ID format:
- Polymarket: <marketAddress>:Polymarket:<exchangeAddress>:<networkId> (e.g., 0x25aa90b3cd98305e849189b4e8b770fc77fe89bccb7cf9656468414e01145d38:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137)
- Kalshi: <marketSlug>:Kalshi (e.g., KXMVECROSSCATEGORY-S2026A4A05B370DF-F1FBA451AA9:Kalshi)
Subscribe using marketId to track real-time stats for a specific prediction market (outcome)
Price values range from 0.00 to 1.00, representing 0% to 100% probability
Updates stream in real-time whenever a trade occurs on this specific market

Troubleshooting Tips

What do the price values represent?

Prices represent the probability of that outcome occurring. A price of 0.65 means the market thinks there’s a 65% chance of this outcome. Prices are denominated in the collateral token (usually $1 = 1 share if this outcome wins).

What's the difference between market stats and event stats?

Event stats (onDetailedPredictionEventStatsUpdated) aggregate data across all outcomes in an event, while market stats track a single specific outcome. Use event stats for overall market activity and market stats for outcome-specific price movements.

How is competitive score calculated for a single market?

For individual markets, the competitive score measures how close the price is to 0.50 (maximum uncertainty). Prices near 0.50 indicate highly contested outcomes, while prices near 0.00 or 1.00 show strong consensus.

Why would I track individual markets instead of events?

Track individual markets when you care about specific outcome probabilities and price movements. This is useful for charting outcome odds, triggering alerts on probability thresholds, or building trading bots focused on specific outcomes.

Can multiple markets for the same event have different activity?

Yes. In multi-outcome events (e.g., “Who will win the election?” with 5 candidates), some outcomes may be heavily traded while others are ignored. Each market streams updates independently based on its own trading activity.

⌘I