Skip to main content
GET
Get market price history for an event
affiliate_ids is optional: pass any number of sportsbook ids, or omit it for every sportsbook your plan includes. limit applies to each market (default 1000, maximum 5000; at most 15,000 rows per response, so more than 3 markets lowers each market’s limit to 15,000 divided by the number of markets). With main_line=true, affiliate_ids is required and takes 1 to 3 sportsbook ids, and limit caps the whole response. Omitting it, a blank value, 0, or a non-numeric id returns HTTP 400: affiliate_ids is required with main_line=true; pass 1 to 3 sportsbook ids. More than 3 distinct ids returns HTTP 400: with main_line=true, affiliate_ids accepts at most 3 sportsbook ids per request. These requests are rejected before any history read. affiliate_ids=0 is not a scores-only sentinel here. market_ids still defaults to 1,2,3 (maximum 12).

Endpoint details

Returns recorded price changes for the requested markets and sportsbooks, subject to your plan’s historical-data access. Data can be available before, during, or after an event as prices are recorded. Each response is bounded by the requested limit. Each market is read on its own. affiliate_ids is optional and takes any number of sportsbook ids; omitted means every sportsbook your plan includes. limit applies to each market, and one response carries at most 15,000 rows (more than 3 markets lowers each market’s limit to 15,000 divided by the number of markets). With main_line=true, affiliate_ids is required and takes 1 to 3 sportsbook ids, for example 19, 19,23, or 19,23,22, and limit caps the whole response. Repeated ids count once. Omitting the parameter, a blank value, 0, or a non-numeric id returns HTTP 400: affiliate_ids is required with main_line=true; pass 1 to 3 sportsbook ids. More than 3 distinct ids returns HTTP 400: with main_line=true, affiliate_ids accepts at most 3 sportsbook ids per request. These requests are rejected before any history read. affiliate_ids=0 is not a scores-only sentinel here.

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

Comma-separated market IDs to filter. Defaults to 1,2,3; maximum 12. Filtered literally, so live IDs are not added automatically; pass 41,42,43,96 for in-play history (for example 1,2,3,41,42,43,96).

affiliate_ids
string

Optional comma-separated sportsbook ids, any number. Omitted means every sportsbook your plan includes; ids your plan does not include are left out. Repeated ids count once.

Required with main_line=true, where it takes 1 to 3 ids, for example 19 (DraftKings), 19,23 (DraftKings and FanDuel), or 19,23,22 (DraftKings, FanDuel, and BetMGM). There, missing, blank, 0, or a non-numeric id returns HTTP 400 with affiliate_ids is required with main_line=true; pass 1 to 3 sportsbook ids, and more than 3 distinct ids returns HTTP 400 with with main_line=true, affiliate_ids accepts at most 3 sportsbook ids per request. This endpoint does not treat affiliate_ids=0 as a scores-only sentinel.

from
string<date-time>

Inclusive start time (RFC3339)

to
string<date-time>

Inclusive end time (RFC3339)

limit
integer
default:1000

Maximum rows per requested market. One response carries at most 15,000 rows, so more than 3 markets lowers each market's limit to 15,000 divided by the number of markets. With main_line=true, maximum rows across all markets. Invalid or out-of-range values use 1000.

Required range: x <= 5000
main_line
enum<string>
default:false

When true, return only history rows (or chart points) that were the sportsbook's main line when written: is_main_line = true on history rows, m = true on chart points. Sorted by time, each change of the line value for a participant is a main-line move at that timestamp.

Available options:
true,
false

Response

Market price history, newest first across markets. There is no paging cursor or truncation flag; narrow the request scope or time window if a market reaches its limit.

meta
object
history
object[]