curl --request GET \
--url https://therundown.io/api/v2/markets \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/markets"
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/markets', 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/markets",
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/markets"
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/markets")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/markets")
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[
{
"id": 1,
"name": "moneyline",
"line_value_is_participant": true,
"proposition": true,
"description": "Win the game outright.",
"short_description": "Moneyline",
"period_id": 0,
"live_variant_id": 41,
"updated_at": "2026-04-12T15:56:16Z",
"class": "core",
"family": "moneyline",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
3,
4,
5,
6,
7,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
25,
27,
30,
32,
33,
34,
38,
39
]
},
{
"id": 2,
"name": "handicap",
"line_value_is_participant": false,
"proposition": true,
"description": "Win or lose by a specified margin.",
"short_description": "Spread",
"period_id": 0,
"live_variant_id": 42,
"updated_at": "2026-04-12T15:56:16Z",
"class": "core",
"family": "spread",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
3,
4,
5,
6,
7,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
25,
27,
30,
32,
33,
34,
38,
39
]
},
{
"id": 3,
"name": "totals",
"line_value_is_participant": false,
"proposition": true,
"description": "Over/under on the combined score.",
"short_description": "Total",
"period_id": 0,
"live_variant_id": 43,
"updated_at": "2026-04-12T15:56:17Z",
"class": "core",
"family": "total",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
3,
4,
5,
6,
7,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
25,
27,
30,
32,
33,
34,
38,
39
]
},
{
"id": 4,
"name": "moneyline_first_half",
"line_value_is_participant": true,
"proposition": true,
"description": "Moneyline for the first half.",
"short_description": "1st Half Moneyline",
"period_id": 1,
"live_variant_id": 1024,
"updated_at": "2026-04-12T15:56:17Z",
"class": "core",
"family": "moneyline",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
4,
5,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
25,
32,
33
]
}
]List all market definitions
Browse the V2 market catalog by market ID, with classification, sport membership and in-play flags. Filters are optional and combine with AND.
curl --request GET \
--url https://therundown.io/api/v2/markets \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/markets"
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/markets', 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/markets",
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/markets"
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/markets")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/markets")
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[
{
"id": 1,
"name": "moneyline",
"line_value_is_participant": true,
"proposition": true,
"description": "Win the game outright.",
"short_description": "Moneyline",
"period_id": 0,
"live_variant_id": 41,
"updated_at": "2026-04-12T15:56:16Z",
"class": "core",
"family": "moneyline",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
3,
4,
5,
6,
7,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
25,
27,
30,
32,
33,
34,
38,
39
]
},
{
"id": 2,
"name": "handicap",
"line_value_is_participant": false,
"proposition": true,
"description": "Win or lose by a specified margin.",
"short_description": "Spread",
"period_id": 0,
"live_variant_id": 42,
"updated_at": "2026-04-12T15:56:16Z",
"class": "core",
"family": "spread",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
3,
4,
5,
6,
7,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
25,
27,
30,
32,
33,
34,
38,
39
]
},
{
"id": 3,
"name": "totals",
"line_value_is_participant": false,
"proposition": true,
"description": "Over/under on the combined score.",
"short_description": "Total",
"period_id": 0,
"live_variant_id": 43,
"updated_at": "2026-04-12T15:56:17Z",
"class": "core",
"family": "total",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
3,
4,
5,
6,
7,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
25,
27,
30,
32,
33,
34,
38,
39
]
},
{
"id": 4,
"name": "moneyline_first_half",
"line_value_is_participant": true,
"proposition": true,
"description": "Moneyline for the first half.",
"short_description": "1st Half Moneyline",
"period_id": 1,
"live_variant_id": 1024,
"updated_at": "2026-04-12T15:56:17Z",
"class": "core",
"family": "moneyline",
"scope": "game",
"settlement": "event",
"live": false,
"sports": [
1,
2,
4,
5,
8,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
25,
32,
33
]
}
]Authorizations
Query Parameters
Optional comma-separated class filter. Accepted tokens: core, prop, future, special. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values within this filter combine with OR; different filters combine with AND. An unknown token returns 400.
Optional comma-separated family filter. Accepted tokens: moneyline, spread, total, team_total, player_ou, winning_margin, outright_winner, top_scorer, win_total, top_n_finish, make_cut, exact_result, other. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values combine with OR, and filters combine with AND. An unknown token returns 400.
Optional comma-separated scope filter. Accepted tokens: game, team, player, competition. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values combine with OR, and filters combine with AND. An unknown token returns 400. Definitions without a recorded scope are excluded when this filter is active.
Optional comma-separated settlement filter. Accepted tokens: event, tournament, season. Tokens are trimmed, case-sensitive and deduplicated; blank tokens are ignored. An empty or whitespace-only value is absent. Values combine with OR, and filters combine with AND. An unknown token returns 400.
Optional positive sport ID, from 1 to 4294967295. An empty or whitespace-only value is absent. Not checked against a sport registry: an unknown valid ID returns an empty array when membership is known. Selects markets without trimming each market's full sports array. Returns 503 if membership is temporarily unknown and no confirmed state is available.
1 <= x <= 4294967295Response
Market catalog definitions, optionally filtered