> ## Documentation Index > Fetch the complete documentation index at: https://enterprise.predexon.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Outcomes by Predexon ID > Find all equivalent outcomes across venues for a predexon_id ## 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` ```json theme={null} { "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 ```json theme={null} { "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). ## OpenAPI ````yaml GET /v2/sports/outcomes/{predexon_id} openapi: 3.1.0 info: title: Predexon Enterprise API description: Unified cross-venue prediction market discovery version: 1.0.0 servers: - url: https://api.predexon.com security: - apiKey: [] paths: /v2/sports/outcomes/{predexon_id}: get: tags: - sports summary: Get Outcomes By Predexon Id description: >- Find all venue listings for a canonical sports predexon_id. predexon_id is a canonical outcome ID shared across matched venues. operationId: get_outcomes_by_predexon_id_v2_sports_outcomes__predexon_id__get parameters: - name: predexon_id in: path required: true schema: type: string title: Predexon Id responses: '200': description: Successful response content: application/json: schema: {} example: 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 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential. ````