curl --request GET \
--url https://therundown.io/api/v2/sports/{sportID}/events/{date} \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/sports/{sportID}/events/{date}"
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}/events/{date}', 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}/events/{date}",
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}/events/{date}"
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}/events/{date}")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/sports/{sportID}/events/{date}")
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": "193500000"
},
"events": [
{
"event_id": "ada1bad2588972bb0f0e4debf9ed92b5",
"sport_id": 4,
"event_uuid": "11f2-1f6d-22f0a800-8cca-2165a45d5e4a",
"event_date": "2027-02-03T01:00:00Z",
"score": {
"event_status": "STATUS_SCHEDULED",
"score_away": 0,
"score_home": 0,
"game_period": 0,
"game_clock": 0
},
"teams": [
{
"team_id": 23,
"name": "Los Angeles",
"mascot": "Lakers",
"abbreviation": "LAL",
"record": "38-18",
"is_away": true,
"is_home": false
},
{
"team_id": 1,
"name": "Boston",
"mascot": "Celtics",
"abbreviation": "BOS",
"record": "42-14",
"is_away": false,
"is_home": true
}
],
"schedule": {
"event_name": "Los Angeles Lakers at Boston Celtics",
"season_type": "Regular Season",
"season_year": 2026
},
"markets": [
{
"market_id": 1,
"period_id": 0,
"name": "moneyline",
"participants": [
{
"id": 23,
"type": "TYPE_TEAM",
"name": "Los Angeles Lakers",
"lines": [
{
"value": "",
"prices": {
"19": {
"price": 150,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": 155,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
},
{
"id": 1,
"type": "TYPE_TEAM",
"name": "Boston Celtics",
"lines": [
{
"value": "",
"prices": {
"19": {
"price": -180,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": -185,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
}
]
},
{
"market_id": 2,
"period_id": 0,
"name": "handicap",
"participants": [
{
"id": 23,
"type": "TYPE_TEAM",
"name": "Los Angeles Lakers",
"lines": [
{
"value": "4.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": -108,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
},
{
"id": 1,
"type": "TYPE_TEAM",
"name": "Boston Celtics",
"lines": [
{
"value": "-4.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": -112,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
}
]
},
{
"market_id": 3,
"period_id": 0,
"name": "totals",
"participants": [
{
"id": 1001,
"type": "TYPE_RESULT",
"name": "Over",
"lines": [
{
"value": "224.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
}
}
}
]
},
{
"id": 1002,
"type": "TYPE_RESULT",
"name": "Under",
"lines": [
{
"value": "224.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
}
}
}
]
}
]
}
]
}
]
}V2: Get events by sport and date
Retrieve events and markets for one sport and date. Review UTC offsets, market and book filters, scores-only requests and closed-price options.
curl --request GET \
--url https://therundown.io/api/v2/sports/{sportID}/events/{date} \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/sports/{sportID}/events/{date}"
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}/events/{date}', 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}/events/{date}",
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}/events/{date}"
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}/events/{date}")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/sports/{sportID}/events/{date}")
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": "193500000"
},
"events": [
{
"event_id": "ada1bad2588972bb0f0e4debf9ed92b5",
"sport_id": 4,
"event_uuid": "11f2-1f6d-22f0a800-8cca-2165a45d5e4a",
"event_date": "2027-02-03T01:00:00Z",
"score": {
"event_status": "STATUS_SCHEDULED",
"score_away": 0,
"score_home": 0,
"game_period": 0,
"game_clock": 0
},
"teams": [
{
"team_id": 23,
"name": "Los Angeles",
"mascot": "Lakers",
"abbreviation": "LAL",
"record": "38-18",
"is_away": true,
"is_home": false
},
{
"team_id": 1,
"name": "Boston",
"mascot": "Celtics",
"abbreviation": "BOS",
"record": "42-14",
"is_away": false,
"is_home": true
}
],
"schedule": {
"event_name": "Los Angeles Lakers at Boston Celtics",
"season_type": "Regular Season",
"season_year": 2026
},
"markets": [
{
"market_id": 1,
"period_id": 0,
"name": "moneyline",
"participants": [
{
"id": 23,
"type": "TYPE_TEAM",
"name": "Los Angeles Lakers",
"lines": [
{
"value": "",
"prices": {
"19": {
"price": 150,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": 155,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
},
{
"id": 1,
"type": "TYPE_TEAM",
"name": "Boston Celtics",
"lines": [
{
"value": "",
"prices": {
"19": {
"price": -180,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": -185,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
}
]
},
{
"market_id": 2,
"period_id": 0,
"name": "handicap",
"participants": [
{
"id": 23,
"type": "TYPE_TEAM",
"name": "Los Angeles Lakers",
"lines": [
{
"value": "4.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": -108,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
},
{
"id": 1,
"type": "TYPE_TEAM",
"name": "Boston Celtics",
"lines": [
{
"value": "-4.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
},
"23": {
"price": -112,
"is_main_line": true,
"updated_at": "2027-02-02T23:28:00Z"
}
}
}
]
}
]
},
{
"market_id": 3,
"period_id": 0,
"name": "totals",
"participants": [
{
"id": 1001,
"type": "TYPE_RESULT",
"name": "Over",
"lines": [
{
"value": "224.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
}
}
}
]
},
{
"id": 1002,
"type": "TYPE_RESULT",
"name": "Under",
"lines": [
{
"value": "224.5",
"prices": {
"19": {
"price": -110,
"is_main_line": true,
"updated_at": "2027-02-02T23:30:00Z"
}
}
}
]
}
]
}
]
}
]
}Endpoint details
Returns events with full market/odds data for the specified sport and date. This is the primary endpoint for building odds screens.main_line=true also excludes closed prices while selecting main lines.
For known zero-delay access, this response’s positive whole-integer meta.delta_last_id can bootstrap /api/v2/markets/delta only when this response explicitly reports X-Data-Delay-Seconds: 0. If that header is positive, absent, or invalid, use scoped snapshots instead; do not start market-delta polling with 0.
Scores-only discovery
Setaffiliate_ids=0 to retain events, scores and status without markets or price objects, including events without markets. Select an exact event, discover its markets with GET /api/v2/events/{eventID}/markets, then request prices from GET /api/v2/events/{eventID} with the desired market and sportsbook filters.
Review offset when selecting a date. For open main-line prices, set main_line=true; use hide_closed=true to exclude closed prices in other line views. Both flags default to false.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 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. Defaults to 1,2,3 (Moneyline, Spread, Total); for soccer leagues and NHL the default is 1,2,3,563. The soccer 3-way moneyline (home/draw/away) is served on market 1 as three participants; market 563 carries the NHL 60-minute regulation-time line.
Limit: 12 market IDs per request. Requests with more than 12 IDs are rejected with a 400: split larger requests into batches of 12, or omit the parameter to use the default.
On market-definition endpoints (/api/v2/events/{eventID}/markets, /api/v2/sports/{sportID}/markets/{date}), omitting market_ids returns all available market definitions instead of the default set.
Common IDs: 1=Moneyline, 2=Spread, 3=Total, 29=Player Points, 35=Player Rebounds, 38=Three Pointers, 39=Player Assists, 93=Player PRA, 94=Team Totals.
Live variants: 41=Live ML, 42=Live Spread, 43=Live Total.
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.