> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convallax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Markets

> Discover which Polymarket markets have option series available for trading on Convallax.

No authentication required — this is a public read endpoint. **Do not** send an `X-API-Key` header; it is neither required nor checked.

Start here to discover which markets are available. Each entry tells you:

* **`conditionId`** — pass this to [List Series](/api-reference/series/list) to see every individual option series for that market.
* **`strikes`** — which strike prices (in basis points) are available.
* **`expiries`** — which expiry dates are available (Unix timestamps).
* **`optionTypes`** — whether calls, puts, or both are listed.

### Typical workflow

1. Call `GET /v1/markets` to see what's tradeable.
2. Pick a market and call `GET /v1/series?conditionId=0x...` to browse its series.
3. Open a quote request with the desired series parameters.


## OpenAPI

````yaml api-reference/openapi.json GET /v1/markets
openapi: 3.1.0
info:
  title: Convallax RFQ API
  version: 3.0.0
  description: >-
    REST surface for the Convallax options protocol — a non-custodial
    request-for-quote marketplace for European calls and puts on Polymarket YES
    outcomes, settled on Polygon.


    **Wire format**: JSON. Successful responses include `"success": true`;
    failures return `{ "success": false, "error": "..." }`.


    **Authentication**: Takers (traders) need no API key — authorization happens
    on-chain at `fill()`. Market makers authenticate with a per-MM API key sent
    as `X-API-Key` (or `?apiKey=`).


    **Streaming**: Quote-request and live-pricing streams use Server-Sent Events
    and the post-trade channel uses WebSocket; those are documented in the
    guides and are not part of this request/response reference.
servers:
  - url: https://api.convallax.com
    description: Production
security: []
tags:
  - name: Series
    description: Browse registered option series available for trading.
  - name: Trading
    description: Open quote requests, read live quotes, and commit to the best price.
  - name: Market Maker
    description: >-
      Submit quotes and confirmation signatures. Authenticated with a per-MM API
      key.
  - name: Settlement
    description: Compute TWAP resolution prices and sign settlement attestations.
  - name: Testnet
    description: Polygon Amoy testnet USDC faucet.
  - name: User
    description: >-
      Account profile and self-serve API keys. Authenticated with a Privy access
      token.
paths:
  /v1/markets:
    get:
      tags:
        - Series
      summary: List Markets
      description: >-
        List all Polymarket markets that have registered option series on
        Convallax. Each entry includes the condition ID, market name, available
        strikes, expiries, and total series count. Use the returned
        `conditionId` to filter the List Series endpoint.
      operationId: listMarkets
      responses:
        '200':
          description: List of markets with option series
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketsListResponse'
components:
  schemas:
    MarketsListResponse:
      type: object
      properties:
        success:
          type: boolean
          const: true
        count:
          type: integer
          description: Number of markets.
          example: 2
        markets:
          type: array
          items:
            $ref: '#/components/schemas/MarketInfo'
    MarketInfo:
      type: object
      description: A Polymarket market with registered Convallax option series.
      properties:
        name:
          type: string
          description: Human-readable market name.
          example: Hantavirus pandemic in 2026?
        conditionId:
          type: string
          description: Polymarket condition ID (bytes32 hex).
          example: '0xa4ddc18895cc7b14810283ef8f113939abffd3969c6a0e37f1897110c67e6f73'
        yesClobTokenId:
          type: string
          description: Polymarket YES CLOB token ID.
          example: >-
            51508280778202349361616850684455231843716212176724253736363122559269229712002
        seriesCount:
          type: integer
          description: Total number of option series for this market.
          example: 126
        strikes:
          type: array
          items:
            type: integer
          description: Available strike values in basis points.
          example:
            - 35
            - 40
            - 45
            - 50
            - 55
            - 60
            - 65
            - 70
            - 75
        expiries:
          type: array
          items:
            type: integer
          description: Available expiry timestamps (Unix seconds).
          example:
            - 1780272000
            - 1782864000
            - 1785542400
        optionTypes:
          type: array
          items:
            type: string
            enum:
              - call
              - put
          description: Available option types.
          example:
            - call
            - put

````