> ## Documentation Index > Fetch the complete documentation index at: https://docs.parlayx.com/llms.txt > Use this file to discover all available pages before exploring further. # Look Up Market > Resolves a venue identifier back to the canonical market and its outcomes. Provide exactly one identifier. ## OpenAPI ````yaml /openapi/v1.json get /v1/markets openapi: 3.0.0 info: title: ParlayX API version: 1.0.0 description: Aggregated prediction-market trading API servers: - url: https://api.parlayx.com security: [] tags: - name: Authentication description: Confirm your signing and read the server clock. - name: Discovery description: Browse sports, competitions, events, and markets. - name: Polymarket description: Submit and manage orders on Polymarket outcomes. - name: Kalshi description: Submit and manage orders on Kalshi markets. paths: /v1/markets: get: tags: - Discovery summary: Look Up Market description: >- Resolves a venue identifier back to the canonical market and its outcomes. Provide exactly one identifier. operationId: lookupMarket parameters: - name: PX-Key-Id in: header required: true schema: type: string description: The key id issued for your signing keypair. - name: PX-Timestamp in: header required: true schema: type: string description: >- Unix seconds at signing, valid within 30 seconds of the server clock. - name: PX-Signature in: header required: true schema: type: string description: Ed25519 signature of the request - name: PX-Content-Sha256 in: header required: true schema: type: string description: >- Hex SHA-256 of the request body, or the SHA-256 of the empty string when there is no body. - schema: type: string description: Look up by Polymarket token id. example: >- 7132104567925221259462638553270691275033272857194253228963137931245558399256 required: false name: tokenId in: query - schema: type: string description: Look up by Kalshi market ticker. example: KXMLBGAME-26JUL25SFPHI-SF required: false name: ticker in: query - schema: type: string description: Look up by Polymarket condition id. example: '0x1234abcd' required: false name: conditionId in: query - schema: type: string description: Look up by Polymarket market slug. example: giants-vs-phillies-2026-07-25 required: false name: slug in: query responses: '200': description: The resolved markets content: application/json: schema: $ref: '#/components/schemas/LookupMarketResponse' '400': description: Not exactly one identifier provided content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: LookupMarketResponse: type: object properties: markets: type: array items: $ref: '#/components/schemas/EventMarket' description: The canonical markets the venue identifier resolves to. required: - markets ApiError: type: object properties: error: type: object properties: code: $ref: '#/components/schemas/ApiErrorCode' message: type: string description: Plain-text explanation of the error. orderId: type: string format: uuid description: >- The affected order, present only on ORDER_RECONCILIATION_REQUIRED; read it back to determine whether it reached the venue. required: - code - message required: - error EventMarket: type: object properties: id: type: string description: Unique identifier for the market. example: mkt_36b618b2-a9ee-529a-9854-0c5ce1ca04cc title: type: string description: Human-readable market title. example: 'Vinnie Pasquantino: Home Runs O/U 0.5' line: type: string description: The over/under or handicap line, when the market has one. example: '0.5' outcomes: type: array items: $ref: '#/components/schemas/Outcome' description: The outcomes in the market. required: - id - title - outcomes ApiErrorCode: type: string enum: - INVALID_REQUEST - NOT_FOUND - INSUFFICIENT_BALANCE - IDEMPOTENCY_CONFLICT - ORDER_NOT_CANCELLABLE - ORDER_RECONCILIATION_REQUIRED - INTERNAL_ERROR description: Stable identifier for the error category. Outcome: type: object properties: name: type: string description: Name of the outcome. example: Over listings: type: array items: $ref: '#/components/schemas/Listing' description: >- The venues this outcome is listed on, each with the id to place an order. required: - name - listings Listing: oneOf: - $ref: '#/components/schemas/PolymarketListing' - $ref: '#/components/schemas/KalshiListing' - $ref: '#/components/schemas/ProphetXListing' discriminator: propertyName: venue mapping: POLYMARKET: $ref: '#/components/schemas/PolymarketListing' KALSHI: $ref: '#/components/schemas/KalshiListing' PROPHETX: $ref: '#/components/schemas/ProphetXListing' title: Listing PolymarketListing: type: object properties: venue: type: string enum: - POLYMARKET tokenId: type: string description: Polymarket token id used to place the order. example: >- 18880079750227829983884034851154743863020946982779905261595472835484541675290 executable: type: boolean description: Whether this listing can be traded today. required: - venue - tokenId - executable title: PolymarketListing KalshiListing: type: object properties: venue: type: string enum: - KALSHI ticker: type: string description: Kalshi market ticker used to place the order. example: KXMLBHR-26JUL241840KCDET-KCVPASQUANTINO9-1 side: type: string enum: - 'YES' - 'NO' description: Kalshi contract side for this outcome. example: 'YES' executable: type: boolean description: Whether this listing can be traded today. required: - venue - ticker - side - executable title: KalshiListing ProphetXListing: type: object properties: venue: type: string enum: - PROPHETX strikeId: type: string minLength: 1 description: >- The ProphetX strike to trade, which identifies both the market and the side. example: ab39fb9a7b4eb6a26d7e26f885c601c1 executable: type: boolean description: Whether this listing can be traded today. required: - venue - strikeId - executable title: ProphetXListing ````