Skip to main content
GET
List all market definitions

Authorizations

X-TheRundown-Key
string
header
required

Recommended API key request header for new integrations

Query Parameters

class
string

Optional comma-separated class filter. Accepted tokens: core, prop, future, special. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values within this filter combine with OR; different filters combine with AND. An unknown token returns 400.

family
string

Optional comma-separated family filter. Accepted tokens: moneyline, spread, total, team_total, player_ou, winning_margin, outright_winner, top_scorer, win_total, top_n_finish, make_cut, exact_result, other. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values combine with OR, and filters combine with AND. An unknown token returns 400.

scope
string

Optional comma-separated scope filter. Accepted tokens: game, team, player, competition. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values combine with OR, and filters combine with AND. An unknown token returns 400. Definitions without a recorded scope are excluded when this filter is active.

settlement
string

Optional comma-separated settlement filter. Accepted tokens: event, tournament, season. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values combine with OR, and filters combine with AND. An unknown token returns 400.

sport_id
integer<int64>

Optional positive sport ID, from 1 to 4294967295. An empty or whitespace-only value is absent. Not checked against a sport registry: an unknown valid ID returns an empty array when membership is known. Selects markets without trimming each market's full sports array. Returns 503 if membership is temporarily unknown and no confirmed state is available.

Required range: 1 <= x <= 4294967295

Response

Market catalog definitions, optionally filtered

class
string
required

Market classification. Defaults to special when no catalog entry exists. The response may contain values outside the current filter vocabulary.

family
string
required

Market family. Defaults to other when no catalog entry exists. The response may contain values outside the current filter vocabulary.

settlement
string
required

When the market settles. Defaults to event when no catalog entry exists. The response may contain values outside the current filter vocabulary.

live
boolean
required

True for a definition whose period_id is an in-play period.

sports
integer[]
required

Full sport membership, sorted by sport ID. Always an array, empty when no membership is available. A sport_id filter does not trim it.

id
integer
Example:

1

name
string
Example:

"Money Line"

description
string
short_description
string
line_value_is_participant
boolean

If true, the selection is carried by the participant and line values may be placeholders or labels. If false, the line value is meaningful and should be displayed when present.

proposition
boolean

Whether this is a proposition/prop market

period_id
integer | null

Associated period. 0=Full Game, 1=1st Half, 2=2nd Half, 3-6=Quarters/periods, 7=Live Full Game, 13-18=Live periods. For tennis, 3/4 represent prematch Set 1/Set 2 and 15/16 represent live Set 1/Set 2.

live_variant_id
integer | null

ID of the live/in-play variant of this market

updated_at
string<date-time>
scope
string

What the outcome refers to. Omitted when no scope is recorded; no default. The response may contain values outside the current filter vocabulary.

display_group
enum<string>

Optional display-group override. Omitted when absent or outside the listed values.

Available options:
main,
game,
team,
player