Get futures for a sport
v2GetFuturesForSportGet futures for a sport 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.
Read-only Product data or price calculation. Use returned canonical IDs. Access, delay and metered usage follow your connected account; never infer coverage from an empty result. One bounded request, no background polling or automatic retry. Affiliate 27 is excluded. No wagers, account changes or guarantee of returns.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| query | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| plan | No | ||
| empty | No | ||
| error | No | ||
| usage | No | ||
| status | No | ||
| message | No | ||
| event_id | No | ||
| source_url | No | ||
| retry_after | No | ||
| limit_reason | No | ||
| retrieved_at | No | ||
| required_plan | No | ||
| remaining_points | No | ||
| missing_entitlement | No | ||
| monthly_remaining_points | No |