Skip to main content
GET
Get futures for a sport

Endpoint details

Returns futures/outright competition events (e.g. tournament winner) for a sport, with future-class markets in the standard V2 market → participants → lines → prices shape and per-market settlement state. Competition events are excluded from the dated game endpoints and served only here. Early access — requires an Ultra plan or higher. A competition is an interval, not an instant: event_date is when it starts and settle_by is when it must have graded. Futures events carry no teams array and no score — the human-readable identity is schedule.event_name. Date filtering uses interval overlap. An event is returned when its [event_date, settle_by] span intersects the requested window — settle_by >= from and event_date <= to. So the default from=now means “in flight right now” and matches a season future that started months ago. Paging is keyset-based (no skip parameter). When more results exist the response carries meta.next_cursor; pass it back verbatim as cursor. Ordering is soonest-to-resolve first: settle_by, then event_date, then event_id. meta.count is the number of events on the page, meta.has_more says whether another page exists, and meta.total is the number of events matching your filters across all pages, so a single call tells you the size of the listing. Default visibility: settled markets are removed per market, an event is hidden once every requested future-class market on it has settled, and terminal (final/canceled/abandoned) events are excluded. include_settled=true lifts all of those and the default from=now, so settled history is reachable. Delta bootstrap: On known zero-delay access, meta.delta_last_id can seed GET /api/v2/markets/delta only when this snapshot explicitly reports X-Data-Delay-Seconds: 0; it is a positive whole-integer cursor. With a positive, absent, or invalid delay header, keep using scoped snapshots and do not substitute 0. Futures market IDs are not in the delta feed’s default set — pass them explicitly (e.g. market_ids=1141) when polling. See the Futures guide for the full integration recipe.

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

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
from
string

Start of the window. A competition is returned when its settle_by is at or after this, i.e. it has not finished yet. RFC3339 timestamp or YYYY-MM-DD; date-only values use the offset timezone. Defaults to now, with two exceptions where it is left unbounded instead: when include_settled=true (so settled history, whose intervals ended in the past, stays reachable), and when an explicit to is itself already in the past (defaulting from to now would describe an inverted, always-empty window).

to
string

End of the window. A competition is returned when its event_date (start) is at or before this. RFC3339 timestamp or YYYY-MM-DD, inclusive; date-only values use the offset timezone. Unbounded when omitted.

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

limit
integer
default:50

Maximum events returned per page (values above 200 are clamped to 200).

Required range: x <= 200
cursor
string

Opaque keyset page token. Pass meta.next_cursor from the previous response verbatim; omit for the first page. Do not parse or construct the token.

include_settled
boolean
default:false

Set to true to include settled markets (with their graded settlement entries) and terminal (finished/canceled) competition events. Also lifts the default from=now, so settled history is reachable: add explicit from/to bounds to scope it.

market_ids
string

Comma-separated market IDs, intersected with the future-class market set (1141 = Tournament Winner on every futures sport; golf adds 1392–1396). When omitted, all future-class markets are returned. Game-market IDs match no markets here (events still return, with empty markets arrays).

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.

Response

Futures events retrieved successfully

meta
object
events
object[]