Get Outcomes by Predexon ID - Predexon Partner

Get Outcomes By Predexon Id

curl --request GET \
  --url https://api.predexon.com/v2/sports/outcomes/{predexon_id} \
  --header 'x-api-key: <api-key>'

{
  "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"
    }
  ]
}

GET

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>'

{
  "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"
    }
  ]
}

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?” A predexon_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

Cached for 60 seconds (cache key is sorted IDs, so order doesn’t matter).

Authorizations

x-api-key

string

header

required

Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential.

Path Parameters

predexon_id

string

required

Response

Successful response

Get Market List Live States

​Overview

​Path Parameters

​Response Fields

​Venue entry

​Errors

​Example

​Caching

​Batch Lookup

​Query Parameters

​Response

​Response Fields

​Errors

Authorizations

Path Parameters

Response

Overview

Path Parameters

Response Fields

Venue entry

Errors

Example

Caching

Batch Lookup

Query Parameters

Response

Response Fields

Errors