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

# List markets

> Returns the trading markets currently available to your account. Use this response as the source of truth for pair identifiers, base and quote currencies, price precision, quantity precision, minimum notional, fee basis points, and active trading status before creating orders.



## OpenAPI

````yaml /openapi/openapi.json get /partner/exchange/markets
openapi: 3.1.0
info:
  title: Stabyl API
  description: >-
    REST API for approved Stabyl accounts to automate exchange, wallet, and
    non-production simulation workflows.
  contact:
    name: Stabyl Support
    email: support@stabyl.com
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.stabyl.com/v1
    description: Production
  - url: https://api-staging.stabyl.com/v1
    description: Staging
security: []
tags:
  - name: Exchange
    description: Trading market data and order management for account automation.
  - name: Wallets
    description: >-
      Supported routes, deposit destinations, balances, transactions, and saved
      recipients.
  - name: Webhooks
    description: >-
      Outbound event delivery configuration and eventually consistent delivery
      history. Verify Standard Webhooks webhook-id, webhook-timestamp, and
      webhook-signature headers against the unchanged raw request body before
      parsing JSON.
  - name: Simulation
    description: Non-production endpoints for testing integration behavior.
paths:
  /partner/exchange/markets:
    get:
      tags:
        - Exchange
      summary: List markets
      description: >-
        Returns the trading markets currently available to your account. Use
        this response as the source of truth for pair identifiers, base and
        quote currencies, price precision, quantity precision, minimum notional,
        fee basis points, and active trading status before creating orders.
      operationId: get_partner_exchange_markets
      responses:
        '200':
          description: List of trading markets
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/MarketsResponse'
                  status:
                    type: string
                    enum:
                      - success
              example:
                data:
                  markets:
                    - base_currency: USD
                      is_active: true
                      maker_fee_bps: 1
                      min_base_lot: '0.01'
                      min_notional: '100.00'
                      pair_id: USD/NGN
                      quote_currency: NGN
                      taker_fee_bps: 3
                      tick_size: '0.01'
                status: success
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: string
                        example: UNAUTHORIZED
                      message:
                        type: string
                        example: missing X-Api-Key header
                  status:
                    type: string
                    enum:
                      - error
              example:
                error:
                  code: UNAUTHORIZED
                  message: missing X-Api-Key header
                status: error
      security:
        - api_key: []
components:
  schemas:
    MarketsResponse:
      type: object
      description: Collection of trading markets available to the account.
      required:
        - markets
      properties:
        markets:
          type: array
          items:
            $ref: '#/components/schemas/MarketInfo'
          description: List of available markets
    MarketInfo:
      type: object
      description: >-
        Trading market metadata, including pair identifier, base and quote
        currencies, precision, minimum order size, fee basis points, and active
        status.
      required:
        - pair_id
        - base_currency
        - quote_currency
        - tick_size
        - min_base_lot
        - min_notional
        - maker_fee_bps
        - taker_fee_bps
        - is_active
      properties:
        base_currency:
          type: string
          description: Base currency symbol
          example: USDT
        is_active:
          type: boolean
          description: Whether the market is active
        maker_fee_bps:
          type: integer
          format: int32
          description: Maker fee in basis points
          example: 1
        min_base_lot:
          type: string
          description: Minimum order size in base currency
          example: '0.01'
        min_notional:
          type: string
          description: Minimum order value in quote currency
          example: '100.00'
        pair_id:
          type: string
          description: Trading pair identifier
          example: USD/NGN
        quote_currency:
          type: string
          description: Quote currency symbol
          example: NGN
        taker_fee_bps:
          type: integer
          format: int32
          description: Taker fee in basis points
          example: 3
        tick_size:
          type: string
          description: Minimum price increment
          example: '0.01'
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        API credential. Withdrawal quote and submit operations additionally
        require the documented Ed25519 timestamp, nonce, and signature headers.
      x-default: sb_test_your_key

````