Skip to main content
GET
Get opening lines for a sport and date

Endpoint details

Returns events with the earliest recorded price for each available line at each sportsbook. Opening snapshots are available whenever a price has been recorded, including before, during, or after an event.

Authorizations

X-TheRundown-Key
string
header
required

Recommended API key request header for new integrations

Path Parameters

sportID
integer
required

Sport ID. Common values: 1=NCAAF, 2=NFL, 3=MLB, 4=NBA, 5=NCAAB, 6=NHL, 7=UFC, 8=WNBA, 9=CFL, 10=MLS, 11=EPL, 16=UEFA Champions League, 17=UEFA Europa League (listed as UEFAEURO; 33 returns no events), 34=Liga MX, 38=ATP Tennis, 39=WTA Tennis, 40=PGA Tour Golf, 41=Formula 1

date
string<date>
required

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
offset
integer
default:0

UTC offset in minutes for the date boundary. US zone values change with daylight saving time (daylight / standard), so use the value in effect on the date you request. Eastern 240 / 300, Central 300 / 360, Mountain 360 / 420, Pacific 420 / 480. Without this, the API day boundary is midnight UTC.

Example:

300

market_ids
string
default:1,2,3

Comma-separated market IDs. Defaults to 1,2,3 (Moneyline, Spread, Total); for soccer leagues and NHL the default is 1,2,3,563. The soccer 3-way moneyline (home/draw/away) is served on market 1 as three participants; market 563 carries the NHL 60-minute regulation-time line. Limit: 12 market IDs per request. Requests with more than 12 IDs are rejected with a 400: split larger requests into batches of 12, or omit the parameter to use the default. On market-definition endpoints (/api/v2/events/{eventID}/markets, /api/v2/sports/{sportID}/markets/{date}), omitting market_ids returns all available market definitions instead of the default set. Common IDs: 1=Moneyline, 2=Spread, 3=Total, 29=Player Points, 35=Player Rebounds, 38=Three Pointers, 39=Player Assists, 93=Player PRA, 94=Team Totals. Live variants: 41=Live ML, 42=Live Spread, 43=Live Total.

affiliate_ids
string

Comma-separated sportsbook/affiliate IDs to filter. Common values include DraftKings (19), FanDuel (23), BetMGM (22), BookMaker (7), BetCRIS (9), Pinnacle (3), Polymarket US (31), Circa Sports (32), Bet105 (33), and Heritage Sports (34). Availability varies by sport and market. On V2 event endpoints (/api/v2/sports/{sportID}/events/{date}, /api/v2/events/{eventID}, and their openers/closing siblings), affiliate_ids=0 is a scores-only sentinel: the response keeps events, scores, and status and omits markets and price objects. Other endpoints that share this parameter treat affiliate_ids as a sportsbook filter only.

main_line
enum<string>
default:false

Only return main lines (primary odds, not alternates). On opening and closing endpoints, this selects main lines in the snapshot. Use history to follow which line was main at each timestamp.

Available options:
true,
false
event_status
string

Comma-separated event status strings to include (e.g. STATUS_IN_PROGRESS,STATUS_HALFTIME). Applied before exclude_status.

exclude_status
string

Comma-separated event status strings to exclude. Applied after event_status.

hide_closed
enum<string>
default:false

Exclude currently closed lines when true. Omit or set false to retrieve completed historical snapshots; an event can remain when no prices match.

Available options:
true,
false

Response

200 - application/json

Events with opening market prices

meta
object | null
events
object[]