Skip to main content
GET
Get available markets for an event

Authorizations

X-TheRundown-Key
string
header
required

Recommended API key request header for new integrations

Path Parameters

eventID
string
required

Canonical V2 event ID from the event_id field returned by event endpoints

Query Parameters

odds_format
enum<string>
default:american

Odds representation for supported REST prices. Omit the parameter or use american to preserve the existing American format. Supported values are american, decimal, fractional, and probability (a 0..1 fraction). Fractional odds are reduced ratio strings. Decimal and probability values preserve the source number or numeric-string type. Nulls, nonnumeric sentinels, off-board values such as 0 and 0.0001, and numeric values with absolute value below 100 remain unchanged. Price-delta fields remain in American-point difference units. Empty, repeated, or unsupported values return HTTP 400. WebSocket messages are unchanged.

Available options:
american,
decimal,
fractional,
probability
market_ids
string

Optional comma-separated market IDs, trimmed with blank tokens ignored. Omit or leave blank to return all market definitions available for this event; this endpoint does not use the event-price endpoint's default market IDs 1,2,3. At most 12 IDs are accepted; more returns HTTP 400.

participant_ids
string

Optional comma-separated participant IDs (up to 99 tokens). Tokens are trimmed and blank tokens ignored; excess tokens after the first 99 are ignored. This filter applies independently of participant_type.

participant_type
enum<string>

Optional participant type. Only the exact uppercase values TYPE_TEAM, TYPE_PLAYER, and TYPE_RESULT activate this filter; other values are ignored rather than rejected.

Available options:
TYPE_TEAM,
TYPE_PLAYER,
TYPE_RESULT
affiliate_ids
string

Optional comma-separated affiliate IDs used to filter the price rows that determine which market definitions are returned. On this endpoint, 0 is an ordinary filter value, not the scores-only sentinel used by selected event-odds endpoints.

hide_closed
string

Omitted, blank, or the case-insensitive exact value false includes definitions with matching closed-price rows. Any other nonempty value filters to currently open price rows. The value is not whitespace-trimmed. This event endpoint uses hide_closed, not hide_closed_markets.

class
string

Optional comma-separated catalog class filter: core, prop, future, special. Values are case-sensitive, trimmed, and blank tokens are ignored. Valid values are OR-combined; class and family filters combine with AND. Unknown tokens are ignored, and an all-unknown or blank filter is absent. Uncatalogued markets use class=special for this filter.

family
string

Optional comma-separated catalog family filter: moneyline, spread, total, team_total, player_ou, winning_margin, outright_winner, top_scorer, win_total, top_n_finish, make_cut, exact_result, other. Values are case-sensitive, trimmed, and blank tokens are ignored. Valid values are OR-combined; class and family filters combine with AND. Unknown tokens are ignored, and an all-unknown or blank filter is absent. Uncatalogued markets use family=other for this filter.

Response

Available markets

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>