Skip to main content
Prediction Market data is currently in beta. It is actively being worked on and improved, but may be unreliable. Polymarket data is live, and Kalshi data will be added soon.Subscriptions require a Growth or Enterprise plan. Learn more.

​
Returns

​
Arguments

​
Subscription example

subscription {
  onDetailedPredictionMarketStatsUpdated(
    marketId: "0x25aa90b3cd98305e849189b4e8b770fc77fe89bccb7cf9656468414e01145d38:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137"
  ) {
    lastTransactionAt
    lifecycle {
      ageSeconds
      expectedLifespanSeconds
      timeToResolutionSeconds
      isResolved
      winningOutcomeId
    }
    statsMin5 {
      start
      end
      statsCurrency {
        volumeUsd
        volumeCT
        openOpenInterestUsd
        closeOpenInterestUsd
      }
      statsNonCurrency {
        trades
        uniqueTraders
      }
      statsChange {
        volumeChange
        tradesChange
      }
      scores {
        trending
        relevance
        competitive
      }
    }
    statsHour1 {
      statsCurrency {
        volumeUsd
      }
      statsNonCurrency {
        trades
        uniqueTraders
      }
    }
    statsDay1 {
      statsCurrency {
        volumeUsd
      }
      statsNonCurrency {
        trades
      }
    }
    trendingScores {
      score5m
      score1
      score4
      score12
      score24
      score1w
    }
    allTimeStats {
      volumeUsd
      volumeCT
      venueVolumeUsd
    }
  }
}
Example Response
{
  "data": {
    "onDetailedPredictionMarketStatsUpdated": {
      "lastTransactionAt": 1773356943,
      "lifecycle": {
        "ageSeconds": 11592478,
        "expectedLifespanSeconds": 12027533,
        "timeToResolutionSeconds": 435055,
        "isResolved": false,
        "winningOutcomeId": null
      },
      "statsMin5": {
        "start": 1773356640,
        "end": 1773357000,
        "statsCurrency": {
          "volumeUsd": "2441",
          "volumeCT": "2442",
          "openOpenInterestUsd": "8219750",
          "closeOpenInterestUsd": "8219750"
        },
        "statsNonCurrency": {
          "trades": 4,
          "uniqueTraders": 1
        },
        "statsChange": {
          "volumeChange": 151.5625,
          "tradesChange": 3
        },
        "scores": {
          "trending": 0.3179737717217025,
          "relevance": 0.7518398963622758,
          "competitive": 0.00028312879456631314
        }
      },
      "statsHour1": {
        "statsCurrency": {
          "volumeUsd": "3679"
        },
        "statsNonCurrency": {
          "trades": 485,
          "uniqueTraders": 23
        }
      },
      "statsDay1": {
        "statsCurrency": {
          "volumeUsd": "2787963"
        },
        "statsNonCurrency": {
          "trades": 4884
        }
      },
      "trendingScores": {
        "score5m": 0.3179737717217025,
        "score1": 0.2784615419805427,
        "score4": 0.38295093043975303,
        "score12": 0.46375984101869644,
        "score24": 0.40366629545667476,
        "score1w": 0.4400265051438401
      },
      "allTimeStats": {
        "volumeUsd": "71642660",
        "volumeCT": "71839682",
        "venueVolumeUsd": "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

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