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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "v2GetFuturesForSport"
}
}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 |