PredictionMarketClassification

role

PredictionMarketRole!

Per-market role within the event (same value as the legacy marketRole). See PredictionMarketRole

Show Properties

MONEYLINE

enum

Single-market outright winner (e.g. Polymarket two-outcome moneyline).

MONEYLINE_OUTCOME

enum

One side of a split head-to-head moneyline (typically 2-3 markets per event: per-team Yes/No for a single game/half/quarter/period, plus optional Tie). Group all markets in an event with this role to reconstruct the logical moneyline.

ENTRANT

enum

One entrant in a large-field tournament/championship outright (e.g. Kalshi “NBA Champion?” with one Yes/No market per team in the league). Distinct from MONEYLINE_OUTCOME by field size and event shape.

SPREAD

enum

Point spread / handicap.

TOTAL

enum

Over/under total.

PROP

enum

Player or team prop.

THRESHOLD_BUCKET

enum

One bucket of a price-threshold ladder (e.g. “BTC > $80k”).

DATE_BUCKET

enum

One bucket of a date ladder (e.g. “Before 2027”).

EXOTIC

enum

Exotic market (BTTS, correct score, method of victory, etc.).

OTHER

enum

Fallback.

sortKey

Int

Position of this market within the event’s display list (lower = show first). Folds in ladder ordering for THRESHOLD_BUCKET / DATE_BUCKET events; equivalent to suggestedOrder ?? displayOrder on the legacy fields.

segment

PredictionMarketSegment!

Sub-event period (set, half, game, etc.) and/or stat (points, rebounds, …). Always present; type = NONE for non-sports markets and whole-match sports markets. The groupingKey field encodes the documented “stat wins over period” precedence so clients don’t have to. See PredictionMarketSegment

Show Properties

type

PredictionMarketSegmentType!

Which dimension dominates: STAT (a stat is present, regardless of period), PERIOD (only a period is present), or NONE (neither — full-match market). See PredictionMarketSegmentType

Show Properties

STAT

enum

A stat keyword was detected — group by stat regardless of period.

PERIOD

enum

Only a period (set/half/game/…) was detected.

NONE

enum

Neither stat nor period — full-match market.

period

String

Period token if detected: e.g. “set_1”, “1h”, “game_2”, “map_3”, “period_2”, “ot”. Snake_case slug. Null when the market covers the full match.

stat

PredictionMarketStatType

Stat dimension if a stat keyword was detected (points, rebounds, assists, …). Null otherwise. See PredictionMarketStatType

Show Properties

POINTS

enum

REBOUNDS

enum

ASSISTS

enum

THREES

enum

STEALS

enum

BLOCKS

enum

TURNOVERS

enum

FOULS

enum

DOUBLE_DOUBLE

enum

TRIPLE_DOUBLE

enum

FIRST_INNING_RUNS

enum

groupingKey

String!

Convenience grouping key. Equals stat ?? period ?? "match". Use this when partitioning markets within an event into sub-event groups: stat takes precedence over period (a “1H Player Points” market groups with other points markets, not other 1H markets).

numberValue

Float

Numeric segment value when the period/stat slug carries an ordinal or numeric component (for example set/game/map/round number). Null when no numeric segment value is available.

entrant

PredictionMarketEntrant

Populated when role = ENTRANT. Identifies the kind of entrant (person, team, country, …) and provides type-specific hints (e.g. ISO 3166-1 alpha-2 country code). See PredictionMarketEntrant

Show Properties

kind

PredictionMarketEntrantKind!

Kind of entity this entrant represents. See PredictionMarketEntrantKind

Show Properties

PERSON

enum

Real person — politician, executive, public figure (not a sports player).

PLAYER

enum

Sports player or driver.

TEAM

enum

Sports team or franchise.

COUNTRY

enum

Country (Eurovision, Olympics outright, etc.).

COMPANY

enum

Company / corporation / brand.

TOPIC

enum

Multi-select / pick-N topic item (policy item, demand, agenda topic).

TV_SHOW

enum

TV show.

MOVIE

enum

Movie.

SONG

enum

Song.

ALBUM

enum

Album.

OTHER

enum

Fallback.

displayName

String!

Cleaned display name for the entrant (mirrors the existing suggestedLabel field).

imageUrl

String

Per-market image URL when available (mirrors the existing per-market image).

countryCode

String

ISO 3166-1 alpha-2 country code (e.g. “SE”). Populated when kind = COUNTRY and the label resolves to a known country.

thresholdBucket

PredictionMarketThresholdBucket

Populated when role = THRESHOLD_BUCKET. Carries the parsed numeric rung value, comparison operator, and metric kind (price, temperature, tweets, …). Saves clients from re-parsing the label. See PredictionMarketThresholdBucket

Show Properties

metric

PredictionMarketLadderMetric!

What the rung is measuring (price, stock price, temperature in °C, social-media count, …). See PredictionMarketLadderMetric

Show Properties

PRICE

enum

Generic asset price (crypto, commodities-fallback).

STOCK_PRICE

enum

Equity stock price.

FDV

enum

Fully-diluted valuation / market cap threshold.

COMMODITY

enum

Commodity price (oil, gas, metals, etc.).

TEMPERATURE

enum

Daily high/low temperature in °C.

RATE_CHANGE_BPS

enum

Federal Reserve rate change in basis points.

ROTTEN_TOMATOES

enum

Rotten Tomatoes Tomatometer score.

BOX_OFFICE

enum

Movie box-office opening-weekend gross.

TWEETS

enum

Tweet count.

FOLLOWERS

enum

Follower count.

SUBSCRIBERS

enum

Subscriber count.

VIEWS

enum

View / stream count.

LIKES

enum

Like count.

POSTS

enum

Post count.

OTHER

enum

Fallback.

operator

PredictionMarketLadderOperator!

How the rung relates to its bound(s). See PredictionMarketLadderOperator

Show Properties

ABOVE

enum

Strictly greater than numericValue (”≥” is normalised to ABOVE).

BELOW

enum

Strictly less than numericValue (”≤” is normalised to BELOW).

EXACTLY

enum

Equal to numericValue (single-strike or exact-match bucket).

BETWEEN

enum

Inclusive range between lowerBound and upperBound.

numericValue

Float

Single comparison value for ABOVE / BELOW / EXACTLY (e.g. 80000 for “BTC > $80k”).

lowerBound

Float

Lower bound for BETWEEN-style range buckets (e.g. “

80k-

90k” → 80000).

upperBound

Float

Upper bound for BETWEEN-style range buckets (e.g. “

80k-

90k” → 90000).

dateBucket

PredictionMarketDateBucket

Populated when role = DATE_BUCKET. Carries the parsed timestamp(s) and operator (BEFORE / AFTER / ON / BETWEEN). See PredictionMarketDateBucket

Show Properties

operator

PredictionMarketDateOperator!

How the rung relates to its date bound(s). See PredictionMarketDateOperator

Show Properties

BEFORE

enum

AFTER

enum

BETWEEN

enum

unixTimestamp

Int

Single unix timestamp (seconds) for BEFORE / AFTER / ON.

lowerTimestamp

Int

Lower bound timestamp (seconds) for BETWEEN buckets.

upperTimestamp

Int

Upper bound timestamp (seconds) for BETWEEN buckets.

rawSubtype

String

Original subtype slug emitted by the classifier (e.g. “first_half_spread”, “player_points”). Provided so clients can forward-ship support for new subtypes before this schema gains structured fields for them.

Used By

Returned by

eventScopedFilterPredictionMarkets: Filters prediction markets within a single event and returns structured classification metadata for each market. Use this instead of filterPredictionMarkets when you need entrant/segment/ladder details (country codes, period+stat grouping, parsed numeric/date rungs) without re-parsing labels client-side.
filterPredictionMarkets: Filters prediction markets using optional text, IDs, event constraints, and ranking criteria.

Documentation Index

​Used By

Used By