Skip to main content
GET
/
v2
/
outcomes
/
{predexon_id}
Get Canonical Outcome
curl --request GET \
  --url https://api.predexon.com/v2/outcomes/{predexon_id} \
  --header 'x-api-key: <api-key>'
{
  "predexon_id": "px-udfdzy5gtmm4kdoa",
  "event_id": "fl1-asm-met-2026-05-02",
  "market_type": "game_winner",
  "market_title": "Monaco vs Metz Winner?",
  "starts_at": "2026-05-02T00:00:00+00:00",
  "status": "open",
  "outcome": "asm",
  "outcome_label": "Monaco",
  "claim": "Monaco win fl1-asm-met-2026-05-02.",
  "venues": [
    {
      "venue": "kalshi",
      "market_ticker": "KXLIGUE1GAME-26MAY02FCMASM-ASM",
      "venue_market_title": "Metz vs Monaco Winner?",
      "side": "yes",
      "status": "open",
      "yes_subtitle": "Monaco",
      "selection_label": "Monaco",
      "series": "KXLIGUE1GAME"
    },
    {
      "venue": "polymarket",
      "market_id": "2018979",
      "condition_id": "0x070254c57b7545b0df2dba4a38ef81655a5b41c1f8edf9d466218f58d9a1f600",
      "market_slug": "fl1-met-asm-2026-05-02-asm",
      "venue_market_title": "Will AS Monaco FC win on 2026-05-02?",
      "token_id": "10439835459613392921040201374401440506564152347998894843834931942965004437054",
      "side": "yes",
      "status": "open",
      "selection_label": "Monaco"
    }
  ],
  "league": "fl1"
}

Documentation Index

Fetch the complete documentation index at: https://docs.predexon.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint after discovering a predexon_id to inspect the exact cross-venue equivalence set the Order Router can trade against.
Beta: Canonical market endpoints are in beta. Response fields and match coverage may evolve as we refine the canonical matching system.

​
Endpoint

GET https://api.predexon.com/v2/outcomes/{predexon_id}
Returns one canonical outcome plus every venue-native listing currently mapped to that outcome. Use this endpoint when you already have a predexon_id and need the full cross-venue execution context.

​
Auth

Pass your API key in the x-api-key header. 
curl -sS \
  -H 'x-api-key: YOUR_API_KEY' \
  'https://api.predexon.com/v2/outcomes/px-udfdzy5gtmm4kdoa'

​
Path Parameters

ParameterTypeDescription
predexon_idstringCanonical outcome-level Predexon ID.

​
Response Shape

{
  "predexon_id": "px-...",
  "event_id": "string",
  "market_type": "game_winner",
  "market_title": "string",
  "description": "string",
  "starts_at": "2026-05-02T00:00:00+00:00",
  "status": "open",
  "outcome": "yes",
  "outcome_label": "Yes",
  "claim": "string",
  "venues": [
    {
      "venue": "polymarket",
      "market_id": "string",
      "market_ticker": "string",
      "condition_id": "string",
      "market_slug": "string",
      "venue_market_title": "string",
      "token_id": "string",
      "side": "yes",
      "status": "open",
      "description": "string",
      "yes_subtitle": "string",
      "no_subtitle": "string",
      "selection_label": "string",
      "resolution_source": "string",
      "venue_event_title": "string",
      "venue_event_slug": "string",
      "image_url": "https://...",
      "icon_url": "https://...",
      "category": "string",
      "tags": ["string"],
      "series": "string",
      "end_time": "2026-05-02T00:00:00Z"
    }
  ],
  "league": "mlb"
}
Optional fields are omitted when unavailable.

​
Field Reference

FieldTypeDescription
predexon_idstringCanonical outcome-level trading/routing ID.
event_idstringCanonical market/question scope ID.
market_typestringMarket type. Examples: binary, game_winner.
market_titlestringCanonical market display title.
descriptionstringOptional display description/rules text when available.
starts_atstringOptional ISO timestamp for scheduled markets.
statusstringOutcome status, usually open or closed.
outcomestringCanonical outcome key.
outcome_labelstringHuman-readable canonical outcome label.
claimstringCanonical claim text for this outcome.
venues[]arrayVenue-native executable listings mapped to this canonical outcome.
leaguestringOptional sports league code.

​
Venue Fields

FieldTypeDescription
venuestringVenue name.
market_idstringVenue-native market ID where available. Not canonical.
market_tickerstringKalshi venue-native ticker. Not canonical.
condition_idstringVenue-native condition ID where available. Not canonical.
market_slugstringVenue-native market slug where available.
venue_market_titlestringVenue-native market title.
token_idstringVenue-native executable token ID when the venue has one. Present for on-chain venues such as Polymarket, Limitless, Predict, and Opinion. Not returned for Kalshi.
sidestringVenue-native side, usually yes or no.
statusstringListing status, usually open or closed.
descriptionstringVenue-native description or rules/resolution text when available.
yes_subtitlestringVenue-native YES subtitle/label when available.
no_subtitlestringVenue-native NO subtitle/label when available.
selection_labelstringVenue-native selected outcome/selection label when available.
resolution_sourcestringVenue-native resolution source/oracle when available.
venue_event_idstringVenue-native event/container ID when available.
venue_event_titlestringVenue-native parent event or series title when available.
venue_event_slugstringVenue-native parent event or series slug when available.
image_urlstringVenue-native image URL when available.
icon_urlstringVenue-native icon URL when available.
categorystring or arrayVenue-native category metadata when available.
tagsstring or arrayVenue-native tag metadata when available.
seriesstring or objectVenue-native series metadata when available.
end_timestringVenue-native end, close, or expiration time when available.
Optional venue-native fields are added directly to each venue object when that venue/source provides them. Kalshi does not have token IDs, so Kalshi entries use market_ticker and do not return token_id.

​
Example

curl -sS \
  -H 'x-api-key: YOUR_API_KEY' \
  'https://api.predexon.com/v2/outcomes/px-udfdzy5gtmm4kdoa' \
  | python -m json.tool

{
  "predexon_id": "px-udfdzy5gtmm4kdoa",
  "event_id": "fl1-asm-met-2026-05-02",
  "market_type": "game_winner",
  "market_title": "Monaco vs Metz Winner?",
  "starts_at": "2026-05-02T00:00:00+00:00",
  "status": "open",
  "outcome": "asm",
  "outcome_label": "Monaco",
  "claim": "Monaco win fl1-asm-met-2026-05-02.",
  "venues": [
    {
      "venue": "kalshi",
      "market_ticker": "KXLIGUE1GAME-26MAY02FCMASM-ASM",
      "venue_market_title": "Metz vs Monaco Winner?",
      "side": "yes",
      "status": "open",
      "yes_subtitle": "Monaco",
      "selection_label": "Monaco",
      "series": "KXLIGUE1GAME"
    },
    {
      "venue": "polymarket",
      "market_id": "2018979",
      "condition_id": "0x070254c57b7545b0df2dba4a38ef81655a5b41c1f8edf9d466218f58d9a1f600",
      "market_slug": "fl1-met-asm-2026-05-02-asm",
      "venue_market_title": "Will AS Monaco FC win on 2026-05-02?",
      "token_id": "10439835459613392921040201374401440506564152347998894843834931942965004437054",
      "side": "yes",
      "status": "open",
      "selection_label": "Monaco",
      "description": "Venue-native market description when provided by Polymarket.",
      "resolution_source": "Venue-native resolution source when provided.",
      "venue_event_slug": "fl1-met-asm-2026-05-02",
      "image_url": "https://..."
    }
  ],
  "league": "fl1"
}

​
Errors

StatusReason
404No canonical outcome found for the provided predexon_id.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
predexon_id
string
required

Canonical outcome-level Predexon ID.

Pattern: ^px-[a-z0-9]+$

Response

Successful Response

​
predexon_id
string

Canonical outcome-level trading/routing ID.

​
event_id
string

Canonical market/question scope ID.

​
market_type
string

Market type, e.g. binary or game_winner.

​
market_title
string

Canonical market display title.

​
description
string

Optional display description/rules text when available.

​
starts_at
string<date-time>

Optional ISO timestamp for scheduled markets.

​
status
string

Outcome status, usually open or closed.

​
outcome
string

Canonical outcome key.

​
outcome_label
string

Human-readable canonical outcome label.

​
claim
string

Canonical claim text for this outcome.

​
venues
object[]

Venue-native executable listings mapped to this canonical outcome.

​
league
string

Sports league code when available.