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

# Get Markets

> API reference for GET /api/v1/markets



## OpenAPI

````yaml GET /api/v1/markets
openapi: 3.1.0
info:
  title: prediction-markets-api
  description: API for prediction markets
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://dev-prediction-markets-api.dflow.net
security:
  - api_key: []
tags:
  - name: Candlesticks
    description: Market and event candlesticks relay endpoints
  - name: Events
    description: Event management endpoints
  - name: Markets
    description: Market management endpoints
  - name: Trades
    description: Trade history endpoints
  - name: Series
    description: Series template endpoints
  - name: Tags
    description: Tag and category endpoints
  - name: Sports
    description: Sports filtering endpoints
  - name: Live Data
    description: Live data relay endpoints
  - name: Orderbook
    description: Orderbook endpoints
  - name: Search
    description: Full-text search endpoints
paths:
  /api/v1/markets:
    get:
      tags:
        - Markets
      summary: Get list of markets
      description: Returns a paginated list of all markets.
      operationId: markets
      parameters:
        - name: limit
          in: query
          description: Maximum number of markets to return
          required: false
          schema:
            type: integer
            format: int32
            minimum: 0
        - name: cursor
          in: query
          description: Pagination offset (number of markets to skip)
          required: false
          schema:
            type: integer
            format: int32
            minimum: 0
        - name: isInitialized
          in: query
          description: >-
            Filter markets that are initialized (have a corresponding market
            ledger)
          required: false
          schema:
            type: boolean
        - name: status
          in: query
          description: |-
            Filter markets by status. Available options: initialized, active,
            inactive, closed, determined
          required: false
          schema:
            type: string
        - name: sort
          in: query
          description: |-
            Sort field. Available options: volume, volume24h, liquidity,
            openInterest
          required: false
          schema:
            $ref: '#/components/schemas/SortField'
        - name: order
          in: query
          description: 'Sort order. Available options: asc, desc'
          required: false
          schema:
            $ref: 6b3d6875-5b25-4d27-8ee9-8bd63672ca1d
      responses:
        '200':
          description: List of markets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MultiMarketResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SortField:
      type: string
      enum:
        - volume
        - volume24h
        - liquidity
        - openInterest
        - startDate
    MultiMarketResponse:
      type: object
      required:
        - markets
      properties:
        cursor:
          type:
            - integer
            - 'null'
          format: int32
          minimum: 0
        markets:
          type: array
          items:
            $ref: '#/components/schemas/SingleMarketResponse'
    ErrorResponse:
      type: object
      required:
        - msg
        - code
      properties:
        code:
          type: string
        msg:
          type: string
    SingleMarketResponse:
      type: object
      required:
        - ticker
        - eventTicker
        - marketType
        - title
        - subtitle
        - yesSubTitle
        - noSubTitle
        - openTime
        - closeTime
        - expirationTime
        - status
        - volume
        - result
        - openInterest
        - fractionalTradingEnabled
        - canCloseEarly
        - rulesPrimary
        - accounts
      properties:
        accounts:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/MarketAccountInfo'
          propertyNames:
            type: string
        canCloseEarly:
          type: boolean
        closeTime:
          type: integer
          format: int64
          minimum: 0
        earlyCloseCondition:
          type:
            - string
            - 'null'
        eventTicker:
          type: string
        expirationTime:
          type: integer
          format: int64
          minimum: 0
        fractionalTradingEnabled:
          type: boolean
        marketType:
          type: string
        noAsk:
          type:
            - string
            - 'null'
        noBid:
          type:
            - string
            - 'null'
        noSubTitle:
          type: string
        openInterest:
          type: integer
          format: int64
          minimum: 0
        openInterestFp:
          type:
            - string
            - 'null'
        openTime:
          type: integer
          format: int64
          minimum: 0
        result:
          type: string
        rulesPrimary:
          type: string
        rulesSecondary:
          type:
            - string
            - 'null'
        status:
          type: string
        subtitle:
          type: string
        ticker:
          type: string
        title:
          type: string
        volume:
          type: integer
          format: int64
          minimum: 0
        volume24hFp:
          type:
            - string
            - 'null'
        volumeFp:
          type:
            - string
            - 'null'
        yesAsk:
          type:
            - string
            - 'null'
        yesBid:
          type:
            - string
            - 'null'
        yesSubTitle:
          type: string
    MarketAccountInfo:
      type: object
      required:
        - marketLedger
        - yesMint
        - noMint
        - isInitialized
      properties:
        isInitialized:
          type: boolean
        marketLedger:
          type: string
        noMint:
          type: string
        redemptionStatus:
          type:
            - string
            - 'null'
        scalarOutcomePct:
          type:
            - integer
            - 'null'
          format: int32
          minimum: 0
        yesMint:
          type: string
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Contact hello@dflow.net to obtain an API
        key.

````