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.At least for the time being, this endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
Arguments

​
Example: Get detailed stats for a specific event

{
  detailedPredictionEventStats(
    input: {
      eventId: "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137"
    }
  ) {
    eventId
    predictionEvent {
      protocol
      question
      closesAt
      resolvedAt
      createdAt
    }
    statsHour1 {
      statsCurrency {
        volumeUsd
      }
      statsNonCurrency {
        uniqueTraders
      }
    }
    statsHour4 {
      statsCurrency {
        volumeUsd
      }
    }
    statsDay1 {
      statsCurrency {
        volumeUsd
        closeLiquidityUsd
      }
      statsNonCurrency {
        uniqueTraders
      }
    }
    allTimeStats {
      volumeUsd
    }
  }
}
Example Response
{
  "data": {
    "detailedPredictionEventStats": {
      "eventId": "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137",
      "predictionEvent": {
        "protocol": "POLYMARKET",
        "question": "Fed decision in March?",
        "closesAt": 1773792000,
        "resolvedAt": null,
        "createdAt": 1768590204
      },
      "statsHour1": {
        "statsCurrency": {
          "volumeUsd": "7124"
        },
        "statsNonCurrency": {
          "uniqueTraders": 62
        }
      },
      "statsHour4": {
        "statsCurrency": {
          "volumeUsd": "2835595"
        }
      },
      "statsDay1": {
        "statsCurrency": {
          "volumeUsd": "15371853",
          "closeLiquidityUsd": "32228389"
        },
        "statsNonCurrency": {
          "uniqueTraders": 2553
        }
      },
      "allTimeStats": {
        "volumeUsd": "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 statsCurrency, statsNonCurrency, statsChange (percentage changes vs previous window), and scores
  • 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.