Get Outcomes By Predexon Id
curl --request GET \
--url https://api.predexon.com/v2/sports/outcomes/{predexon_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.predexon.com/v2/sports/outcomes/{predexon_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/outcomes/{predexon_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/outcomes/{predexon_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/outcomes/{predexon_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/outcomes/{predexon_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.predexon.com/v2/sports/outcomes/{predexon_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{
"predexon_id": "px-xz7fw6lsywv2rnwr",
"match_key": "mlb-ari-pit-2026-05-07",
"event_id": "mlb-ari-pit-2026-05-07",
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_id": "KXMLBGAME-26MAY071540PITAZ-AZ",
"market_slug": null,
"condition_id": null,
"market_title": "Pittsburgh vs Arizona Winner?",
"token_id": "KXMLBGAME-26MAY071540PITAZ-AZ-yes",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "open"
},
{
"venue": "polymarket",
"market_slug": "mlb-pit-ari-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"token_id": "927526441864...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "closed"
},
{
"venue": "predict",
"market_id": "266861",
"market_slug": "mlb-pit-ari-2026-05-07",
"condition_id": "0xbe0446535894eb...",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"token_id": "818996600748...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "open"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sports Discovery API
Get Outcomes by Predexon ID
Find all equivalent outcomes across venues for a predexon_id
GET
/
v2
/
sports
/
outcomes
/
{predexon_id}
Get Outcomes By Predexon Id
curl --request GET \
--url https://api.predexon.com/v2/sports/outcomes/{predexon_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.predexon.com/v2/sports/outcomes/{predexon_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/outcomes/{predexon_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/outcomes/{predexon_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/outcomes/{predexon_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/outcomes/{predexon_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.predexon.com/v2/sports/outcomes/{predexon_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{
"predexon_id": "px-xz7fw6lsywv2rnwr",
"match_key": "mlb-ari-pit-2026-05-07",
"event_id": "mlb-ari-pit-2026-05-07",
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_id": "KXMLBGAME-26MAY071540PITAZ-AZ",
"market_slug": null,
"condition_id": null,
"market_title": "Pittsburgh vs Arizona Winner?",
"token_id": "KXMLBGAME-26MAY071540PITAZ-AZ-yes",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "open"
},
{
"venue": "polymarket",
"market_slug": "mlb-pit-ari-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"token_id": "927526441864...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "closed"
},
{
"venue": "predict",
"market_id": "266861",
"market_slug": "mlb-pit-ari-2026-05-07",
"condition_id": "0xbe0446535894eb...",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"token_id": "818996600748...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "open"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Overview
Given a canonical Predexon outcome identifier, return every venue listing for that outcome. This is the primary lookup used by the order router to answer: “Which venues offer this same tradeable side, and what’s the venue-native identifier on each?” Apredexon_id is canonical at the outcome level. The same outcome across Kalshi, Polymarket, Predict.fun, and other venues shares the same predexon_id when matched.
Path Parameters
| Param | Type | Description |
|---|---|---|
predexon_id | string | A Predexon outcome ID (format: px- followed by 12 lowercase alphanumerics). |
Response Fields
| Field | Type | Description |
|---|---|---|
predexon_id | string | Echoes the input. |
match_key | string | Canonical game ID, same as game_id on /markets. |
event_id | string | Canonical market/question identifier. For sports v1 game_winner, this often equals match_key. |
outcome | string | Canonical outcome code (team code or "draw"). |
outcome_label | string | Human-readable label. |
market_type | string | Market type (e.g. "game_winner"). Useful for identifying neg-risk markets for WebSocket subscriptions. |
venues[] | array | One entry per venue offering this outcome. |
Venue entry
| Field | Type | Description |
|---|---|---|
venue | string | One of polymarket, kalshi, limitless, opinion, predict. |
market_id | string? | Venue-native non-condition identifier. Present for Kalshi (ticker), Opinion (integer), and Predict (integer). |
market_slug | string? | Human-readable slug. |
condition_id | string? | On-chain CTF conditionId. Present for Polymarket, Limitless, Predict. |
market_title | string | Venue’s native market title. |
token_id | string | YES-side venue-native token identifier. |
predexon_id | string | Canonical outcome predexon_id. This is the same across matched venue listings. |
side | string | Venue-native side, usually "yes". |
status | string | "open" / "closed". |
Errors
| Status | When |
|---|---|
404 | No outcomes found for this predexon_id. |
Example
GET /v2/sports/outcomes/px-xz7fw6lsywv2rnwr
{
"predexon_id": "px-xz7fw6lsywv2rnwr",
"match_key": "mlb-ari-pit-2026-05-07",
"event_id": "mlb-ari-pit-2026-05-07",
"outcome": "ari",
"outcome_label": "Arizona Diamondbacks",
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_id": "KXMLBGAME-26MAY071540PITAZ-AZ",
"market_title": "Pittsburgh vs Arizona Winner?",
"token_id": "KXMLBGAME-26MAY071540PITAZ-AZ-yes",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "open"
},
{
"venue": "polymarket",
"market_slug": "mlb-pit-ari-2026-05-07",
"condition_id": "0x8a70942639237613...",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"token_id": "927526441864...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "closed"
},
{
"venue": "predict",
"market_id": "266861",
"condition_id": "0xbe0446535894eb...",
"market_slug": "mlb-pit-ari-2026-05-07",
"market_title": "Pittsburgh Pirates vs. Arizona Diamondbacks",
"token_id": "818996600748...",
"predexon_id": "px-xz7fw6lsywv2rnwr",
"side": "yes",
"status": "open"
}
]
}
Caching
Responses are cached for 60 seconds.Batch Lookup
Look up multiple predexon_ids in a single request.GET /v2/sports/outcomes?predexon_ids=px-aaa,px-bbb,px-ccc
Query Parameters
| Param | Type | Description |
|---|---|---|
predexon_ids | string | Comma-separated predexon_ids (max 100) |
Response
{
"results": {
"px-aaa": {
"match_key": "nba-atl-nyk-2026-04-18",
"event_id": "nba-atl-nyk-2026-04-18",
"outcome": "atl",
"outcome_label": "Atlanta Hawks",
"market_type": "game_winner",
"venues": [
{
"venue": "kalshi",
"market_id": "KXNBAGAME-26APR18ATLNYK-ATL",
"market_title": "Atlanta at New York Winner?",
"token_id": "KXNBAGAME-26APR18ATLNYK-ATL-yes",
"predexon_id": "px-aaa",
"side": "yes",
"status": "open"
},
{
"venue": "polymarket",
"condition_id": "0xc3b0...",
"market_title": "Hawks vs. Knicks",
"token_id": "17221...",
"predexon_id": "px-aaa",
"side": "yes",
"status": "open"
}
]
},
"px-bbb": {
"match_key": "nba-atl-nyk-2026-04-18",
"outcome": "nyk",
"outcome_label": "New York Knicks",
"venues": [...]
},
"px-ccc": null
},
"count": 2,
"not_found": ["px-ccc"]
}
Response Fields
| Field | Type | Description |
|---|---|---|
results | object | Dict keyed by input predexon_id. Value is the outcome + venues object, or null if not found. |
count | int | Number of predexon_ids that resolved successfully. |
not_found | array | List of predexon_ids that had no matches. |
Errors
| Status | When |
|---|---|
400 | Empty predexon_ids or more than 100 |
⌘I
