Skip to main content
GET
Get futures for a sport

Authorizations

key
string
query
required

API key as query parameter

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, 33=UEFA Europa League, 38=ATP Tennis, 39=WTA Tennis, 40=PGA Tour Golf, 41=Formula 1

Query Parameters

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. Use 300 for US Central, 240 for Eastern, 360 for Mountain, 420 for Pacific. 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), Bovada (2), Pinnacle (3).

Response

Futures events retrieved successfully

meta
object
events
object[]