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

# List markets

> All public markets with live pool totals, per-outcome stakes, and indicative parimutuel odds. Odds are indicative until betting closes; the final payout is set by the pool at bet_cutoff.



## OpenAPI

````yaml /api-reference/openapi.json get /markets
openapi: 3.1.0
info:
  title: counsel API
  version: 1.0.0
  description: >-
    Public, read-only HTTP API for counsel, an L1-native parimutuel prediction
    market on the XRP Ledger. No API key, no auth, all responses JSON. It
    exposes live market state, indicative odds, unsigned bet construction,
    account positions and profiles, a copy-trading feed, and the
    SourceTag-attributed leaderboard.
  contact:
    name: counsel
    url: https://counsel.markets
  license:
    name: MIT
servers:
  - url: https://api.counsel.markets
    description: Canonical API host
  - url: https://counsel.markets/api/v1
    description: Path-based equivalent
security: []
paths:
  /markets:
    get:
      tags:
        - Markets
      summary: List markets
      description: >-
        All public markets with live pool totals, per-outcome stakes, and
        indicative parimutuel odds. Odds are indicative until betting closes;
        the final payout is set by the pool at bet_cutoff.
      operationId: listMarkets
      responses:
        '200':
          description: Live markets snapshot
          content:
            application/json:
              schema:
                type: object
                required:
                  - markets
                  - source_tag
                  - generated_at
                properties:
                  markets:
                    type: array
                    items:
                      $ref: '#/components/schemas/Market'
                  source_tag:
                    type:
                      - integer
                      - 'null'
                    description: >-
                      counsel's XRPL SourceTag, carried on every attributed
                      transaction.
                    example: 2606220005
                  generated_at:
                    type: string
                    format: date-time
                    description: ISO 8601 timestamp of the indexer snapshot.
components:
  schemas:
    Market:
      type: object
      required:
        - id
        - question
        - family
        - phase
        - status
        - pool_account
        - fee_rate
        - bet_cutoff
        - resolution_time
        - resolution
        - total_xrp
        - total_drops
        - outcomes
      properties:
        id:
          type: string
          description: 'Deterministic id: first 16 hex of sha256(question|resolutionTime).'
          example: 8679dd8bda43f5c1
        question:
          type: string
          example: Will XRP/USD be ≥ $1.13 by midnight ET?
        family:
          type: string
          enum:
            - A
            - B
          description: >-
            A = XLS-47 oracle auto-resolved; B = real-world optimistic
            resolution.
        phase:
          type: string
          enum:
            - open
            - closed
            - resolving
            - disputable
            - resolved
        status:
          type: string
          enum:
            - open
            - resolved
            - void
        pool_account:
          type: string
          description: >-
            XRPL account holding all stakes; outcomes separated by
            DestinationTag.
          example: rNPA3W2Gj3mMTqt6V5KYc5hD2pszdPsV6S
        fee_rate:
          type: number
          description: Flat takeout on the gross pool before the split.
          example: 0.03
        bet_cutoff:
          type: string
          format: date-time
        resolution_time:
          type: string
          format: date-time
        resolution:
          type: object
          required:
            - kind
            - summary
          properties:
            kind:
              type: string
              enum:
                - oracle
                - manual
            summary:
              type: string
              example: XLS-47 XRP/USD >= 1.13
        total_xrp:
          type: number
          example: 0
        total_drops:
          type: string
          description: Total drops staked, decimal string. Use for exact arithmetic.
          example: '0'
        outcomes:
          type: array
          items:
            $ref: '#/components/schemas/Outcome'
    Outcome:
      type: object
      required:
        - index
        - label
        - destination_tag
        - pool_drops
        - pool_xrp
        - bets
        - implied_prob
        - payout_per_unit
      properties:
        index:
          type: integer
          example: 0
        label:
          type: string
          example: 'Yes'
        destination_tag:
          type: integer
          description: DestinationTag for a bet on this outcome. Equals index.
          example: 0
        pool_drops:
          type: string
          example: '0'
        pool_xrp:
          type: number
          example: 0
        bets:
          type: integer
          example: 0
        implied_prob:
          type: number
          description: 'Indicative implied probability: outcome_drops / total_drops.'
          example: 0.5
        payout_per_unit:
          type:
            - number
            - 'null'
          description: >-
            Indicative XRP returned per XRP staked if this outcome wins. null
            when the outcome pool is empty.
          example: 1.94

````