Get Market
curl --request GET \
--url https://api.predexon.com/v2/sports/markets/{game_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.predexon.com/v2/sports/markets/{game_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.predexon.com/v2/sports/markets/{game_id}', 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://api.predexon.com/v2/sports/markets/{game_id}",
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-api-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://api.predexon.com/v2/sports/markets/{game_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-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://api.predexon.com/v2/sports/markets/{game_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.predexon.com/v2/sports/markets/{game_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"game_id": "mlb-ari-pit-2026-05-07",
"league": "mlb",
"league_name": "MLB",
"sport": "baseball",
"game_date": "2026-05-07",
"game_date_timezone": "US/Eastern",
"status": "open",
"title": "Arizona Diamondbacks vs Pittsburgh Pirates",
"market_types": [
{
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_title": "Pittsburgh vs Arizona Winner?",
"outcomes": [
{
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"event_id": "mlb-ari-pit-2026-05-07",
"market_id": "KXMLBGAME-26MAY071540PITAZ-AZ",
"tokens": {
"yes": {
"predexon_id": "px-xz7fw6lsywv2rnwr",
"price": 0
}
}
},
{
"outcome": "pit",
"outcome_label": "Pittsburgh Pirates",
"event_id": "mlb-ari-pit-2026-05-07",
"market_id": "KXMLBGAME-26MAY071540PITAZ-PIT",
"tokens": {
"yes": {
"predexon_id": "px-c3dftfrdu5unmk3g",
"price": 0.99
}
}
}
],
"volume": 41567.16,
"liquidity": 25030.64,
"end_time": "2026-05-07T22:20:55+00:00"
},
{
"venue": "polymarket",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"outcomes": [
{
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"event_id": "mlb-ari-pit-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_slug": "mlb-pit-ari-2026-05-07",
"tokens": {
"yes": {
"token_id": "927526441864...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"price": 0
}
}
},
{
"outcome": "pit",
"outcome_label": "Pittsburgh Pirates",
"event_id": "mlb-ari-pit-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_slug": "mlb-pit-ari-2026-05-07",
"tokens": {
"yes": {
"token_id": "232120875852...",
"predexon_id": "px-c3dftfrdu5unmk3g",
"price": 1
}
}
}
],
"volume": 853880.442333,
"liquidity": 15200.91,
"end_time": "2026-05-14T19:40:00+00:00"
}
],
"event_id": "mlb-ari-pit-2026-05-07"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sports Discovery API
Get Market
Fetch a single game with all venue outcomes
GET
/
v2
/
sports
/
markets
/
{game_id}
Get Market
curl --request GET \
--url https://api.predexon.com/v2/sports/markets/{game_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.predexon.com/v2/sports/markets/{game_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.predexon.com/v2/sports/markets/{game_id}', 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://api.predexon.com/v2/sports/markets/{game_id}",
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-api-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://api.predexon.com/v2/sports/markets/{game_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-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://api.predexon.com/v2/sports/markets/{game_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.predexon.com/v2/sports/markets/{game_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"game_id": "mlb-ari-pit-2026-05-07",
"league": "mlb",
"league_name": "MLB",
"sport": "baseball",
"game_date": "2026-05-07",
"game_date_timezone": "US/Eastern",
"status": "open",
"title": "Arizona Diamondbacks vs Pittsburgh Pirates",
"market_types": [
{
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_title": "Pittsburgh vs Arizona Winner?",
"outcomes": [
{
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"event_id": "mlb-ari-pit-2026-05-07",
"market_id": "KXMLBGAME-26MAY071540PITAZ-AZ",
"tokens": {
"yes": {
"predexon_id": "px-xz7fw6lsywv2rnwr",
"price": 0
}
}
},
{
"outcome": "pit",
"outcome_label": "Pittsburgh Pirates",
"event_id": "mlb-ari-pit-2026-05-07",
"market_id": "KXMLBGAME-26MAY071540PITAZ-PIT",
"tokens": {
"yes": {
"predexon_id": "px-c3dftfrdu5unmk3g",
"price": 0.99
}
}
}
],
"volume": 41567.16,
"liquidity": 25030.64,
"end_time": "2026-05-07T22:20:55+00:00"
},
{
"venue": "polymarket",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"outcomes": [
{
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"event_id": "mlb-ari-pit-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_slug": "mlb-pit-ari-2026-05-07",
"tokens": {
"yes": {
"token_id": "927526441864...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"price": 0
}
}
},
{
"outcome": "pit",
"outcome_label": "Pittsburgh Pirates",
"event_id": "mlb-ari-pit-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_slug": "mlb-pit-ari-2026-05-07",
"tokens": {
"yes": {
"token_id": "232120875852...",
"predexon_id": "px-c3dftfrdu5unmk3g",
"price": 1
}
}
}
],
"volume": 853880.442333,
"liquidity": 15200.91,
"end_time": "2026-05-14T19:40:00+00:00"
}
],
"event_id": "mlb-ari-pit-2026-05-07"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Overview
Fetch the full per-venue detail for a single game by its canonicalgame_id. Returns the same game-level structure as a single entry from GET /v2/sports/markets, but without the pagination wrapper.
Use this when you already have a game_id (for example, from a previous /markets call or from a link in your UI) and want the latest nested view of every venue covering that game.
Path Parameters
| Param | Type | Description |
|---|---|---|
game_id | string | Canonical Predexon game identifier, e.g. nba-atl-nyk-2026-04-18. Format: {league}-{team_a}-{team_b}-{YYYY-MM-DD} with team codes sorted alphabetically. |
Response
A single game object with the same shape as an entry ingames[] from the list endpoint - see the field reference on the List Markets page.
Errors
| Status | When |
|---|---|
404 | No game found with this game_id. |
Example
GET /v2/sports/markets/mlb-ari-pit-2026-05-07
{
"game_id": "mlb-ari-pit-2026-05-07",
"league": "mlb",
"league_name": "MLB",
"sport": "baseball",
"game_date": "2026-05-07",
"game_date_timezone": "US/Eastern",
"title": "Arizona Diamondbacks vs Pittsburgh Pirates",
"status": "open",
"market_types": [
{
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_title": "Pittsburgh vs Arizona Winner?",
"volume": 41567.16,
"liquidity": 25030.64,
"end_time": "2026-05-07T22:20:55+00:00",
"outcomes": [
{
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"event_id": "mlb-ari-pit-2026-05-07",
"market_id": "KXMLBGAME-26MAY071540PITAZ-AZ",
"tokens": {
"yes": { "predexon_id": "px-xz7fw6lsywv2rnwr", "price": 0.0 }
}
},
{
"outcome": "pit",
"outcome_label": "Pittsburgh Pirates",
"event_id": "mlb-ari-pit-2026-05-07",
"market_id": "KXMLBGAME-26MAY071540PITAZ-PIT",
"tokens": {
"yes": { "predexon_id": "px-c3dftfrdu5unmk3g", "price": 0.99 }
}
}
]
}
],
"event_id": "mlb-ari-pit-2026-05-07"
}
]
}
Caching
Responses are cached for 60 seconds.⌘I
