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

# List sampling markets

> Paginated list of sampling markets.



## OpenAPI

````yaml /api-reference/openapi.yaml get /sampling-markets
openapi: 3.0.3
info:
  title: XO Orderbook API
  description: |
    Public REST surface of the XO CLOB API.

    XO mainnet chain id is `3223`. The EIP-712 order domain is
    `XO Market CLOB` with `verifyingContract` set to the
    [CTF Exchange](/) address. See
    [Smart accounts](../guides/smart-accounts) for the smart-account
    identity model and ERC-1271 order signing.

    Wire conventions:
      * Prices are trimmed decimal strings (e.g. `"0.5"`, `"0.555"`).
      * Sizes are decimal-string integers in human shares.
      * Timestamps in trade and book responses are stringified Unix
        seconds / milliseconds (the SDK uses `TimestampSeconds<String>`
        / `TimestampMilliSeconds<String>`).
      * Token IDs are decimal U256 strings; condition IDs are
        `0x`-prefixed 32-byte hex.
  version: 1.0.0
  contact:
    name: XO Market
    url: https://beta.xo.market
servers:
  - url: https://orderbooks.xo.market
    description: Mainnet (XO chain id 3223)
security: []
tags:
  - name: Authentication
    description: >-
      Create and manage API keys. The L1 ClobAuth EIP-712 flow mints HMAC
      credentials that authenticate every other private request.
  - name: Market Data
    description: >-
      Public reads for books, prices, midpoints, spreads, last trades, and price
      history. Also includes server time and per-token configuration.
  - name: Markets
    description: >-
      Discovery for tradable markets, including pagination and SDK-compatible
      simplified shapes.
  - name: Trade
    description: Place, cancel, and inspect orders and trades for the authenticated maker.
  - name: Account
    description: Maker balance, allowance, positions, and claimable settled positions.
paths:
  /sampling-markets:
    get:
      tags:
        - Markets
      summary: List sampling markets
      description: Paginated list of sampling markets.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketsPage'
              example:
                limit: 100
                count: 1
                next_cursor: LTE=
                data:
                  - condition_id: >-
                      0x39a12d52b63969654926e095ddd96f5c459112714da03edca769aa58173c78fb
                    tokens:
                      - token_id: >-
                          26516164265702901957933644848127860370782874751279270726689263951695181556943
                        outcome: 'Yes'
                        price: '0.5'
                      - token_id: >-
                          13730057904096984444199595880113152612639388204530324084054099203558669491245
                        outcome: 'No'
                        price: '0.5'
                    minimum_tick_size: 0.001
                    neg_risk: false
                    active: true
      x-codeSamples:
        - lang: Rust
          label: xo-orderbook-client-rs
          source: >
            use xo_orderbook_client::orderbook::{Client, Config};


            let client = Client::new("https://orderbooks.xo.market",
            Config::default())?;

            let page = client.sampling_markets(None).await?;
components:
  schemas:
    MarketsPage:
      type: object
      required:
        - limit
        - count
        - next_cursor
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MarketObject'
        next_cursor:
          type: string
          description: |
            Base64-encoded offset cursor. Pass back as `next_cursor` on the
            next request. The literal string `"LTE="` is the canonical
            CLOB end-of-stream sentinel — when the gateway returns it,
            there are no more pages. Empty string is also accepted by
            SDKs for first-page requests. NOT nullable — always a string.
        count:
          type: integer
          description: >-
            Number of items in this page (may equal `limit` mid-stream, smaller
            on the final page).
        limit:
          type: integer
          description: Page size requested (default 100, max 500).
    MarketObject:
      type: object
      required:
        - condition_id
        - tokens
        - minimum_tick_size
        - neg_risk
        - active
      properties:
        condition_id:
          type: string
        tokens:
          type: array
          minItems: 2
          maxItems: 2
          items:
            $ref: '#/components/schemas/MarketTokenObject'
        minimum_tick_size:
          type: number
          example: 0.001
        neg_risk:
          type: boolean
        active:
          type: boolean
    MarketTokenObject:
      type: object
      required:
        - token_id
        - outcome
        - price
      properties:
        token_id:
          type: string
        outcome:
          type: string
          enum:
            - true
            - false
        price:
          type: string
          description: |
            Midpoint of this token's book; falls back to last-trade
            price; falls back to `"0.000"`.

````