curl --request GET \
--url https://therundown.io/api/v2/sports/{sportID}/futures \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/sports/{sportID}/futures"
headers = {"X-TheRundown-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-TheRundown-Key': '<api-key>'}};
fetch('https://therundown.io/api/v2/sports/{sportID}/futures', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://therundown.io/api/v2/sports/{sportID}/futures",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-TheRundown-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://therundown.io/api/v2/sports/{sportID}/futures"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-TheRundown-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://therundown.io/api/v2/sports/{sportID}/futures")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/sports/{sportID}/futures")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-TheRundown-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"meta": {
"delta_last_id": "1595215769",
"next_cursor": "MTc4NTY0MzIwMDAwMDAwMDAwMHwxNzg1Mzg0MDAwMDAwMDAwMDAwfDc2ODVhMzJkYTYyOGM3N2UwMzFhMmQ5NzAxMTI4ODgy",
"count": 50,
"has_more": true,
"total": 73
},
"events": [
{
"event_id": "a3d1f9f94f220a45cfd944181569cc46",
"sport_id": 2,
"event_date": "2026-09-10T00:00:00Z",
"settle_by": "2027-02-21T00:00:00Z",
"event_status": "STATUS_SCHEDULED",
"settlement": {},
"schedule": {
"event_name": "NFL Super Bowl Winner (2026 Season)",
"season_year": 2026
},
"markets": [
{
"id": 4967891,
"market_id": 1141,
"period_id": 0,
"name": "tournament_winner",
"market_description": "Tournament Winner",
"participants": [
{
"id": 61,
"type": "TYPE_TEAM",
"name": "Buffalo Bills",
"lines": [
{
"id": "8155509548895b87157633c87df81b3e",
"prices": {
"22": {
"id": "665502535",
"price": 1000,
"is_main_line": true,
"updated_at": "2026-07-29T17:01:46Z"
},
"25": {
"id": "665857721",
"price": 1074,
"is_main_line": true,
"updated_at": "2026-07-29T18:30:25Z"
}
}
}
]
},
{
"id": 63,
"type": "TYPE_TEAM",
"name": "New England Patriots",
"lines": [
{
"id": "b1d9b8b548f232cc35ea2a3995449d3c",
"prices": {
"22": {
"id": "665502553",
"price": 2000,
"is_main_line": true,
"updated_at": "2026-07-29T17:01:46Z"
}
}
}
]
}
]
}
]
}
]
}{
"error": "<string>"
}{
"error": "Futures markets require Ultra plan or higher",
"upgrade_url": "/pricing/api"
}Get futures for a sport
List futures competitions with odds and settlement state. Review interval-overlap date filters and cursor pagination. Requires Ultra or higher.
curl --request GET \
--url https://therundown.io/api/v2/sports/{sportID}/futures \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/sports/{sportID}/futures"
headers = {"X-TheRundown-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-TheRundown-Key': '<api-key>'}};
fetch('https://therundown.io/api/v2/sports/{sportID}/futures', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://therundown.io/api/v2/sports/{sportID}/futures",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-TheRundown-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://therundown.io/api/v2/sports/{sportID}/futures"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-TheRundown-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://therundown.io/api/v2/sports/{sportID}/futures")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/sports/{sportID}/futures")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-TheRundown-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"meta": {
"delta_last_id": "1595215769",
"next_cursor": "MTc4NTY0MzIwMDAwMDAwMDAwMHwxNzg1Mzg0MDAwMDAwMDAwMDAwfDc2ODVhMzJkYTYyOGM3N2UwMzFhMmQ5NzAxMTI4ODgy",
"count": 50,
"has_more": true,
"total": 73
},
"events": [
{
"event_id": "a3d1f9f94f220a45cfd944181569cc46",
"sport_id": 2,
"event_date": "2026-09-10T00:00:00Z",
"settle_by": "2027-02-21T00:00:00Z",
"event_status": "STATUS_SCHEDULED",
"settlement": {},
"schedule": {
"event_name": "NFL Super Bowl Winner (2026 Season)",
"season_year": 2026
},
"markets": [
{
"id": 4967891,
"market_id": 1141,
"period_id": 0,
"name": "tournament_winner",
"market_description": "Tournament Winner",
"participants": [
{
"id": 61,
"type": "TYPE_TEAM",
"name": "Buffalo Bills",
"lines": [
{
"id": "8155509548895b87157633c87df81b3e",
"prices": {
"22": {
"id": "665502535",
"price": 1000,
"is_main_line": true,
"updated_at": "2026-07-29T17:01:46Z"
},
"25": {
"id": "665857721",
"price": 1074,
"is_main_line": true,
"updated_at": "2026-07-29T18:30:25Z"
}
}
}
]
},
{
"id": 63,
"type": "TYPE_TEAM",
"name": "New England Patriots",
"lines": [
{
"id": "b1d9b8b548f232cc35ea2a3995449d3c",
"prices": {
"22": {
"id": "665502553",
"price": 2000,
"is_main_line": true,
"updated_at": "2026-07-29T17:01:46Z"
}
}
}
]
}
]
}
]
}
]
}{
"error": "<string>"
}{
"error": "Futures markets require Ultra plan or higher",
"upgrade_url": "/pricing/api"
}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
Path Parameters
Query Parameters
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.
american, decimal, fractional, probability 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).
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.
300
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).
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.