> ## 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.

# List Event Markets

> Returns the markets for an event: each market's outcomes and the per-venue identifiers needed to place an order.



## OpenAPI

````yaml /openapi/v1.json get /v1/sports/events/{eventId}/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/sports/events/{eventId}/markets:
    get:
      tags:
        - Discovery
      summary: List Event Markets
      description: >-
        Returns the markets for an event: each market's outcomes and the
        per-venue identifiers needed to place an order.
      operationId: listEventMarkets
      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: Identifier of the event to list markets for.
            example: evt_f53758a6
          required: true
          name: eventId
          in: path
      responses:
        '200':
          description: The event's markets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEventMarketsResponse'
        '404':
          description: Event not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    ListEventMarketsResponse:
      type: object
      properties:
        markets:
          type: array
          items:
            $ref: '#/components/schemas/EventMarket'
          description: >-
            The markets for the event, each with its outcomes and per-venue
            listings.
      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

````