predictionEventTopMarketsBars

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

This endpoint requires a Growth or Enterprise plan. Learn more.

Returns

PredictionEventTopMarketsBarsResponse

See PredictionEventTopMarketsBarsResponse

Show Properties

eventId

String!

The ID of the prediction event.

predictionEvent

PredictionEvent

The parent prediction event See PredictionEvent

Show Properties

String!

The unique identifier.

protocol

PredictionProtocol!

The prediction protocol. See PredictionProtocol

Show Properties

POLYMARKET

enum

KALSHI

enum

venueEventId

String!

The venue-specific event ID.

venueSeriesId

String

The venue-specific series ID.

status

PredictionEventStatus!

The current status. See PredictionEventStatus

Show Properties

OPEN

enum

SUSPENDED

enum

RESOLVED

enum

CANCELLED

enum

PENDING

enum

question

String!

The question or title.

url

String!

The external URL.

rulesPrimary

String!

Primary rules text.

rulesSecondary

String

Secondary rules text.

Arguments

input

PredictionEventTopMarketsBarsInput!

required

Input parameters used to select an event, number of markets, and time settings. See PredictionEventTopMarketsBarsInput

Show Properties

eventId

String!

required

The event ID to fetch top markets for

from

Int!

required

Unix timestamp (seconds) for the start of the range

Int!

required

Unix timestamp (seconds) for the end of the range

resolution

PredictionMarketBarsResolution!

required

Resolution for the bars (e.g., min1, min5, hour1, day1) See PredictionMarketBarsResolution

Show Properties

min1

enum

min5

enum

min15

enum

min30

enum

hour1

enum

hour4

enum

hour12

enum

day1

enum

week1

enum

countback

Int

Number of bars to fetch backwards from ‘to’ (alternative to ‘from’)

limit

Int

Maximum number of markets to return (default 5, max 10)

useLeaderboard

Boolean

Use pre-computed leaderboard ranking (overrides rankBy options when true)

rankBy

PredictionMarketRankingAttribute

Market-level attribute to rank by (use this OR rankByOutcome + rankByOutcomeAttribute) See PredictionMarketRankingAttribute

Show Properties

timestamp

enum

lastTransactionAt

enum

age

enum

createdAt

enum

expectedLifespan

enum

opensAt

enum

closesAt

enum

resolvesAt

enum

relevanceScore5m

enum

relevanceScore1h

enum

relevanceScore4h

enum

relevanceScore12h

enum

relevanceScore24h

enum

relevanceScore1w

enum

competitiveScore5m

enum

competitiveScore1h

enum

competitiveScore4h

enum

competitiveScore12h

enum

competitiveScore24h

enum

competitiveScore1w

enum

liquidityUsd

enum

liquidityCT

enum

liquidityChange5m

enum

liquidityChange1h

enum

liquidityChange4h

enum

liquidityChange12h

enum

liquidityChange24h

enum

liquidityChange1w

enum

openInterestUsd

enum

openInterestCT

enum

openInterestChange5m

enum

openInterestChange1h

enum

openInterestChange4h

enum

openInterestChange12h

enum

openInterestChange24h

enum

openInterestChange1w

enum

volumeUsd5m

enum

volumeUsd1h

enum

volumeUsd4h

enum

volumeUsd12h

enum

volumeUsd24h

enum

volumeUsd1w

enum

volumeUsdAll

enum

volumeCTAll

enum

venueVolumeUsd

enum

venueVolumeCT

enum

volumeChange5m

enum

volumeChange1h

enum

volumeChange4h

enum

volumeChange12h

enum

volumeChange24h

enum

volumeChange1w

enum

trades5m

enum

trades1h

enum

trades4h

enum

trades12h

enum

trades24h

enum

trades1w

enum

avgTradeSizeUsd5m

enum

avgTradeSizeUsd1h

enum

avgTradeSizeUsd4h

enum

avgTradeSizeUsd12h

enum

avgTradeSizeUsd24h

enum

avgTradeSizeUsd1w

enum

tradesChange5m

enum

tradesChange1h

enum

tradesChange4h

enum

tradesChange12h

enum

tradesChange24h

enum

tradesChange1w

enum

uniqueTraders5m

enum

uniqueTraders1h

enum

uniqueTraders4h

enum

uniqueTraders12h

enum

uniqueTraders24h

enum

uniqueTraders1w

enum

uniqueTradersChange5m

enum

uniqueTradersChange1h

enum

uniqueTradersChange4h

enum

uniqueTradersChange12h

enum

uniqueTradersChange24h

enum

uniqueTradersChange1w

enum

priceCompetitiveness

enum

volumeImbalance24h

enum

liquidityAsymmetry

enum

impliedProbabilitySum

enum

maxPriceRange5m

enum

maxPriceRange1h

enum

maxPriceRange4h

enum

maxPriceRange12h

enum

maxPriceRange24h

enum

maxPriceRange1w

enum

phraseScore

enum

Score from phrase matching (for search queries)

rankByOutcome

PredictionOutcomeIndex

Which outcome to rank by (use with rankByOutcomeAttribute) See PredictionOutcomeIndex

Show Properties

outcome0

enum

outcome1

enum

rankByOutcomeAttribute

PredictionOutcomeRankingAttribute

Outcome-level attribute to rank by (requires rankByOutcome) See PredictionOutcomeRankingAttribute

Show Properties

bestBidUsd

enum

bestAskUsd

enum

spreadUsd

enum

lastPriceUsd

enum

bestBidCT

enum

bestAskCT

enum

spreadCT

enum

lastPriceCT

enum

liquidityUsd

enum

liquidityCT

enum

twoPercentAskDepthUsd

enum

twoPercentBidDepthUsd

enum

twoPercentAskDepthCT

enum

twoPercentBidDepthCT

enum

highPriceUsd5m

enum

highPriceUsd1h

enum

highPriceUsd4h

enum

highPriceUsd12h

enum

highPriceUsd24h

enum

highPriceUsd1w

enum

lowPriceUsd5m

enum

lowPriceUsd1h

enum

lowPriceUsd4h

enum

lowPriceUsd12h

enum

lowPriceUsd24h

enum

lowPriceUsd1w

enum

volumeUsd5m

enum

volumeUsd1h

enum

volumeUsd4h

enum

volumeUsd12h

enum

volumeUsd24h

enum

volumeUsd1w

enum

volumeChange5m

enum

volumeChange1h

enum

volumeChange4h

enum

volumeChange12h

enum

volumeChange24h

enum

volumeChange1w

enum

volumeShares5m

enum

volumeShares1h

enum

volumeShares4h

enum

volumeShares12h

enum

volumeShares24h

enum

volumeShares1w

enum

buyVolumeUsd5m

enum

buyVolumeUsd1h

enum

buyVolumeUsd4h

enum

buyVolumeUsd12h

enum

buyVolumeUsd24h

enum

buyVolumeUsd1w

enum

sellVolumeUsd5m

enum

sellVolumeUsd1h

enum

sellVolumeUsd4h

enum

sellVolumeUsd12h

enum

sellVolumeUsd24h

enum

sellVolumeUsd1w

enum

trades5m

enum

trades1h

enum

trades4h

enum

trades12h

enum

trades24h

enum

trades1w

enum

buys5m

enum

buys1h

enum

buys4h

enum

buys12h

enum

buys24h

enum

buys1w

enum

sells5m

enum

sells1h

enum

sells4h

enum

sells12h

enum

sells24h

enum

sells1w

enum

tradesChange5m

enum

tradesChange1h

enum

tradesChange4h

enum

tradesChange12h

enum

tradesChange24h

enum

tradesChange1w

enum

priceChange5m

enum

priceChange1h

enum

priceChange4h

enum

priceChange12h

enum

priceChange24h

enum

priceChange1w

enum

priceRange5m

enum

priceRange1h

enum

priceRange4h

enum

priceRange12h

enum

priceRange24h

enum

priceRange1w

enum

rankDirection

RankingDirection

Direction to rank (DESC = highest first) See RankingDirection

Show Properties

ASC

enum

DESC

enum

removeEmptyBars

Boolean

Whether to remove empty bars from the response

marketIds

[String!]

Explicit list of market IDs to fetch (overrides ranking if provided)

Example Queries

Get trending markets ranked by outcome price change

{
  predictionEventTopMarketsBars(input: {
    eventId: "67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137"
    from: 1773347775
    to: 1773349275
    resolution: min15
    limit: 3
    rankByOutcome: outcome0
    rankByOutcomeAttribute: priceChange1h
    rankDirection: DESC
    removeEmptyBars: true
  }) {
    marketBars {
      marketId
      predictionMarket {
        question
        outcomeLabels
      }
      bars {
        t
        volumeUsd
        outcome0 {
          priceUsd {
            o
            h
            l
            c
          }
          liquidityUsd {
            c
          }
        }
      }
    }
  }
}

Example Response

Example response (truncated)

{
  "data": {
    "predictionEventTopMarketsBars": {
      "marketBars": [
        {
          "marketId": "0xdeb615a52cd114e5aa27d8344ae506a72bea81f6ed13f5915f050b615a193c20:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137",
          "predictionMarket": {
            "question": "Will the Fed decrease interest rates by 50+ bps after the March 2026 meeting?",
            "outcomeLabels": [
              "Yes",
              "No"
            ]
          },
          "bars": [
            {
              "t": 1773347400,
              "volumeUsd": "1291.363323",
              "outcome0": {
                "priceUsd": {
                  "o": "0.002",
                  "h": "0.002",
                  "l": "0.002",
                  "c": "0.002"
                },
                "liquidityUsd": {
                  "c": "7145187.310262"
                }
              }
            },
            {
              "t": 1773348300,
              "volumeUsd": "988.200516",
              "outcome0": {
                "priceUsd": {
                  "o": "0.002",
                  "h": "0.002",
                  "l": "0.002",
                  "c": "0.002"
                },
                "liquidityUsd": {
                  "c": "7138365.20336"
                }
              }
            },
            {
              "t": 1773349200,
              "volumeUsd": "703.948227",
              "outcome0": {
                "priceUsd": {
                  "o": "0.002",
                  "h": "0.002",
                  "l": "0.002",
                  "c": "0.002"
                },
                "liquidityUsd": {
                  "c": "7093679.819347"
                }
              }
            }
          ]
        },
        // ... 2 more markets
      ]
    }
  }
}

Usage Guidelines

This query returns bar data for multiple top markets within a prediction event, combining event context with individual market time-series data. It’s useful for comparing market performance, identifying trending markets, and analyzing multi-market events. Key characteristics:

Event ID format: 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)
Batch market data: Get bars for up to 10 markets in a single query
Flexible ranking: Rank markets by volume, liquidity, trending score, or outcome-specific metrics
Complete market context: Each response includes the full market object plus bar data
Efficient querying: Better performance than making multiple individual predictionMarketBars calls
Time-series format: Same OHLC bar structure as predictionMarketBars

Common use cases:

Display multiple markets from an event on a dashboard
Compare trading activity across related markets
Identify the most active or trending markets within an event
Build event overview pages with market-level granularity

Troubleshooting Tips

Should I use rankBy or rankByOutcome + rankByOutcomeAttribute?

Use rankBy for market-level metrics (e.g., volumeUsd24h, liquidityUsd, uniqueTraders24h)
Use rankByOutcome + rankByOutcomeAttribute for outcome-specific metrics (e.g., price changes, outcome-specific volume)

You cannot use both at the same time. Choose based on whether you’re ranking markets by overall activity or by specific outcome performance.

What happens if I specify marketIds?

When you provide marketIds, the ranking parameters are ignored and you’ll get bars for exactly those markets. This is useful when you want specific markets but still benefit from the batch query performance. The limit parameter is also ignored in this case.

Why am I getting fewer than 'limit' markets?

Possible reasons:

The event has fewer markets than your limit
Some markets had no activity in the specified time range (when removeEmptyBars: true)
Some markets don’t have the ranking attribute you specified (e.g., older markets may not have trending scores)

Check the total number of markets in the event using the predictionEvent query.

How do trending scores work for ranking?

What's the difference between rankDirection ASC and DESC?

DESC (descending): Highest values first - use for “top” markets (e.g., highest volume, most liquid)
ASC (ascending): Lowest values first - use for “bottom” markets or when looking for lowest spreads, earliest closing times, etc.

Most use cases want DESC to get the top/best markets.

Can I rank by outcome price but get both outcomes' data?

Yes! The ranking only determines which markets are returned. You can rank by outcome0.priceChange1h but still query full data for both outcome0 and outcome1 in your bars selection. The ranking criterion doesn’t limit what data you receive.

How should I handle the max limit of 10 markets?

The 10-market limit balances comprehensive data with performance. If you need more markets:

Make multiple queries with different ranking criteria
Use pagination by explicitly specifying different marketIds in subsequent queries
Consider whether you truly need more than 10 markets for your UI/analysis

Most dashboards and visualizations work well with 5-10 top markets.

Prediction Event Dashboard: Use multi-market bars for the probability comparison chart on an event page
Prediction Charts: Render multi-candidate probability lines and other chart types

Documentation Index

​Returns

​Arguments

​Example Queries

​Example Response

​Usage Guidelines

​Troubleshooting Tips

​Related Recipes

Returns

Arguments

Example Queries

Example Response

Usage Guidelines

Troubleshooting Tips

Related Recipes