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

# Get market data

> Retrieve a list of markets based on various optional query parameters.



## OpenAPI

````yaml get /markets
openapi: 3.0.0
info:
  title: CoinCap API
  description: >-
    API for accessing cryptocurrency data including assets, rates, exchanges,
    markets, and candles.
  version: '1'
servers:
  - url: https://api.coincap.io/v2
    description: Official CoinCap API Server
  - url: https://virtserver.swaggerhub.com/REXSENDER1/CoinCap/1
    description: SwaggerHub API Auto Mocking
security:
  - bearerAuth: []
tags:
  - name: Asset
    description: >-
      Endpoints related to cryptocurrency data, including details about
      individual assets.
  - name: Rates
    description: Provides exchange rate information for various currencies.
  - name: Exchanges
    description: Information about cryptocurrency exchanges, including trading data.
  - name: Markets
    description: Details about cryptocurrency markets and trading pairs.
  - name: Candles
    description: Historical price data for cryptocurrencies in candlestick format.
paths:
  /markets:
    get:
      tags:
        - Markets
      summary: Get market data
      description: Retrieve a list of markets based on various optional query parameters.
      parameters:
        - name: exchangeId
          in: query
          description: Search by exchange ID.
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: poloniex
        - name: baseSymbol
          in: query
          description: Returns markets containing the base symbol.
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: BTC
        - name: quoteSymbol
          in: query
          description: Returns markets containing the quote symbol.
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: ETH
        - name: baseId
          in: query
          description: Returns markets containing the base ID.
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: bitcoin
        - name: quoteId
          in: query
          description: Returns markets containing the quote ID.
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: ethereum
        - name: assetSymbol
          in: query
          description: Returns all assets containing the symbol (base and quote).
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: BTC
        - name: assetId
          in: query
          description: Returns all assets containing the ID (base and quote).
          required: false
          style: form
          explode: true
          schema:
            type: string
            example: bitcoin
        - name: limit
          in: query
          description: Maximum number of results to return.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            example: 5
        - name: offset
          in: query
          description: Offset for pagination.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            example: 1
      responses:
        '200':
          description: A list of markets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_200_7'
      security:
        - bearerAuth: []
components:
  schemas:
    inline_response_200_7:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/inline_response_200_7_data'
    inline_response_200_7_data:
      type: object
      properties:
        exchangeId:
          type: string
          description: Unique identifier for the exchange.
          example: poloniex
        rank:
          type: integer
          description: Rank based on market volume on the exchange.
          example: 1
        baseSymbol:
          type: string
          description: Symbol for the base asset.
          example: BTC
        baseId:
          type: string
          description: Unique identifier for the base asset.
          example: bitcoin
        quoteSymbol:
          type: string
          description: Symbol for the quote asset.
          example: ETH
        quoteId:
          type: string
          description: Unique identifier for the quote asset.
          example: ethereum
        priceQuote:
          type: string
          description: Price in quote asset for one unit of the base asset.
          example: '0.032'
        priceUsd:
          type: string
          description: Price in USD for one unit of the base asset.
          example: '30.00'
        volumeUsd24Hr:
          type: string
          description: 24-hour volume in USD.
          example: '1000000.00'
        percentExchangeVolume:
          type: string
          description: Percentage of total exchange volume.
          example: '12.5'
        tradesCount24Hr:
          type: integer
          description: Number of trades in the last 24 hours.
          example: 5000
        updated:
          type: integer
          description: UNIX timestamp (milliseconds) for the last update.
          example: 1633017600000
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````