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

# Coins List with Market Data

> A ranked market table across many coins — price, market cap, volume, supply and all-time highs in one call.

A ranked market table covering many coins in one call: one row per coin with `current_price`, `market_cap`, `market_cap_rank`, `total_volume`, `high_24h`, `low_24h`, `price_change_percentage_24h`, `circulating_supply`, `total_supply`, `max_supply`, `ath` and `atl` with their dates, and `image`. Page with `per_page` and `page`, sort with `order` (market cap, volume or id, ascending or descending), and narrow with `ids` or `category`. Passing `price_change_percentage` adds a matching `price_change_percentage_24h_in_currency` field. Use it for leaderboards and segment scans. For the price of a few known coins [`get_coingecko_simple_price`](/docs/api-reference/coingecko/get_coingecko-simple-price) is far lighter; for one coin in full use [`get_coingecko_coins_id`](/docs/api-reference/coingecko/get_coingecko-coins-id).

<Note>
  **First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude
  Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client
  opens a browser, you click Allow once, and there is no key to paste. The
  commands per client, and what each call costs, are on
  [aisa.one/mcp](https://aisa.one/mcp#connect).
</Note>

[Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/coingecko/get_coingecko-coins-markets)


## OpenAPI

````yaml openapi/coingecko.json GET /apis/v1/coingecko/coins/markets
openapi: 3.1.0
info:
  description: ''
  title: CoinGecko
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/coingecko/api/{id}/volume_chart
    - /apis/v1/coingecko/coins/categories
    - /apis/v1/coingecko/coins/categories/list
    - /apis/v1/coingecko/coins/list
    - /apis/v1/coingecko/coins/markets
    - /apis/v1/coingecko/coins/{id}
    - /apis/v1/coingecko/coins/{id}/contract/{contract_address}
    - /apis/v1/coingecko/coins/{id}/contract/{contract_address}/market_chart
    - >-
      /apis/v1/coingecko/coins/{id}/contract/{contract_address}/market_chart/range
    - /apis/v1/coingecko/coins/{id}/history
    - /apis/v1/coingecko/coins/{id}/market_chart
    - /apis/v1/coingecko/coins/{id}/market_chart/range
    - /apis/v1/coingecko/coins/{id}/ohlc
    - /apis/v1/coingecko/coins/{id}/tickers
    - /apis/v1/coingecko/exchanges
    - /apis/v1/coingecko/exchanges/list
    - /apis/v1/coingecko/exchanges/{id}
    - /apis/v1/coingecko/exchanges/{id}/tickers
    - /apis/v1/coingecko/ping
    - /apis/v1/coingecko/search/trending
    - /apis/v1/coingecko/simple/price
    - /apis/v1/coingecko/simple/supported_vs_currencies
    - /apis/v1/coingecko/simple/token_price/{id}
  x-aisa-document:
    facts_hash: 8ef69318521af6ec48c85ef9b2bd710c5bab2a2a0daf19e875de4239445b5074
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:99cbf836874aa8fa8d595f21f9fdb21cc9903f77993505541aa0610dc4b3833e
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: coingecko
  x-aisa-catalogs:
    coingecko:
      title: CoinGecko
      description: ''
      x-aisa-document:
        facts_hash: 8ef69318521af6ec48c85ef9b2bd710c5bab2a2a0daf19e875de4239445b5074
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/coingecko/coins/markets:
    get:
      tags:
        - default
      summary: Coins List with Market Data
      description: >-
        This endpoint allows you to **query all the supported coins with price,
        market cap, volume and market related data**
      operationId: get_coingecko_coins_markets
      parameters:
        - name: category
          in: query
          required: false
          description: >-
            Filter based on coins' category. 

            *refers to
            [`/coins/categories/list`](/reference/coins-categories-list)
          schema:
            type: string
        - name: ids
          in: query
          required: false
          description: |-
            Coins' IDs, comma-separated if querying more than 1 coin. 
            *refers to [`/coins/list`](/reference/coins-list)
          schema:
            type: string
            default: bitcoin
        - name: include_rehypothecated
          in: query
          required: false
          description: >-
            Include rehypothecated tokens in results. When true, returns
            `market_cap_rank_with_rehypothecated` field. 

            Default: false
          schema:
            type: boolean
        - name: include_tokens
          in: query
          required: false
          description: >-
            For `symbols` lookups, specify `all` to include all matching
            tokens. 

            Default `top` returns top-ranked tokens by market cap or volume.
          schema:
            type: string
            enum:
              - top
              - all
        - name: locale
          in: query
          required: false
          description: |-
            Language background. 
            Default: en
          schema:
            type: string
            enum:
              - ar
              - bg
              - cs
              - da
              - de
              - el
              - en
              - es
              - fi
              - fr
              - he
              - hi
              - hr
              - hu
              - id
              - it
              - ja
              - ko
              - lt
              - nl
              - 'no'
              - pl
              - pt
              - ro
              - ru
              - sk
              - sl
              - sv
              - th
              - tr
              - uk
              - vi
              - zh
              - zh-tw
        - name: names
          in: query
          required: false
          description: Coins' names, comma-separated if querying more than 1 coin.
          schema:
            type: string
            default: Bitcoin
        - name: order
          in: query
          required: false
          description: |-
            Sort result by field. 
            Default: market_cap_desc
          schema:
            type: string
            enum:
              - market_cap_asc
              - market_cap_desc
              - volume_asc
              - volume_desc
              - id_asc
              - id_desc
        - name: page
          in: query
          required: false
          description: |-
            Page through results. 
            Default: 1
          schema:
            type: integer
        - name: per_page
          in: query
          required: false
          description: |-
            Total results per page. 
            Default: 100 
            Valid values: 1...250
          schema:
            type: integer
        - name: precision
          in: query
          required: false
          description: Decimal places for currency price value
          schema:
            type: string
            enum:
              - full
              - '0'
              - '1'
              - '2'
              - '3'
              - '4'
              - '5'
              - '6'
              - '7'
              - '8'
              - '9'
              - '10'
              - '11'
              - '12'
              - '13'
              - '14'
              - '15'
              - '16'
              - '17'
              - '18'
        - name: price_change_percentage
          in: query
          required: false
          description: >-
            Include price change percentage timeframe, comma-separated if
            querying more than 1 timeframe. 

            Valid values: `1h`, `24h`, `7d`, `14d`, `30d`, `200d`, `1y`
          schema:
            type: string
        - name: sparkline
          in: query
          required: false
          description: |-
            Include sparkline 7-day data. 
            Default: false
          schema:
            type: boolean
        - name: symbols
          in: query
          required: false
          description: Coins' symbols, comma-separated if querying more than 1 coin.
          schema:
            type: string
            default: btc
        - name: vs_currency
          in: query
          required: true
          description: >-
            Target currency of coins and market data. 

            *refers to
            [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)
          schema:
            type: string
            default: usd
      responses:
        '200':
          description: List of coins with market data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response860C3Ae68Ea5_CoinsMarkets'
              example:
                - id: bitcoin
                  symbol: btc
                  name: Bitcoin
                  image: >-
                    https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400
                  current_price: 77671
                  market_cap: 1555886872303
                  market_cap_rank: 1
                  fully_diluted_valuation: 1555914058873
                  total_volume: 33235034316
                  high_24h: 78419
                  low_24h: 76696
                  price_change_24h: -747.3360347281705
                  price_change_percentage_24h: -0.95302
                  market_cap_change_24h: -15184401491.513184
                  market_cap_change_percentage_24h: -0.9665
                  circulating_supply: 20030493
                  total_supply: 20030843
                  max_supply: 21000000
                  ath: 126080
                  ath_change_percentage: -38.39571
                  ath_date: '2025-10-06T18:57:42.558Z'
                  atl: 67.81
                  atl_change_percentage: 114443.23093
                  atl_date: '2013-07-06T00:00:00.000Z'
                  roi: null
                  last_updated: '2026-05-18T12:49:21.599Z'
                  market_cap_rank_with_rehypothecated: 1
                  sparkline_in_7d:
                    price:
                      - 81045.84776489827
                      - 81001.73089268175
                      - 80898.20817826076
                  price_change_percentage_1h_in_currency: 0.5823392426906319
                  price_change_percentage_24h_in_currency: -0.9530164743774191
                  price_change_percentage_7d_in_currency: -4.042267423689584
                  price_change_percentage_14d_in_currency: -1.5720857443461431
                  price_change_percentage_30d_in_currency: 1.9453890367549207
                  price_change_percentage_200d_in_currency: -29.452371850925864
                  price_change_percentage_1y_in_currency: -25.214612207475373
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response860C3Ae68Ea5_CoinsMarkets:
      type: array
      items:
        type: object
        required:
          - id
          - symbol
          - name
          - image
          - current_price
          - market_cap
          - market_cap_rank
          - fully_diluted_valuation
          - total_volume
          - high_24h
          - low_24h
          - price_change_24h
          - price_change_percentage_24h
          - market_cap_change_24h
          - market_cap_change_percentage_24h
          - circulating_supply
          - total_supply
          - max_supply
          - ath
          - ath_change_percentage
          - ath_date
          - atl
          - atl_change_percentage
          - atl_date
          - roi
          - last_updated
        properties:
          id:
            type: string
            description: Coin ID
          symbol:
            type: string
            description: Coin symbol
          name:
            type: string
            description: Coin name
          image:
            type: string
            description: Coin image URL
          current_price:
            type:
              - number
              - 'null'
            description: Current price in target currency
          market_cap:
            type:
              - number
              - 'null'
            description: Market cap in target currency
          market_cap_rank:
            type:
              - integer
              - 'null'
            description: Market cap rank
          fully_diluted_valuation:
            type:
              - number
              - 'null'
            description: Fully diluted valuation in target currency
          total_volume:
            type:
              - number
              - 'null'
            description: Total trading volume in target currency
          high_24h:
            type:
              - number
              - 'null'
            description: 24-hour price high in target currency
          low_24h:
            type:
              - number
              - 'null'
            description: 24-hour price low in target currency
          price_change_24h:
            type:
              - number
              - 'null'
            description: 24-hour price change in target currency
          price_change_percentage_24h:
            type:
              - number
              - 'null'
            description: 24-hour price change percentage
          market_cap_change_24h:
            type:
              - number
              - 'null'
            description: 24-hour market cap change in target currency
          market_cap_change_percentage_24h:
            type:
              - number
              - 'null'
            description: 24-hour market cap change percentage
          circulating_supply:
            type:
              - number
              - 'null'
            description: Circulating supply
          total_supply:
            type:
              - number
              - 'null'
            description: Total supply
          max_supply:
            type:
              - number
              - 'null'
            description: Max supply
          ath:
            type:
              - number
              - 'null'
            description: All-time high price in target currency
          ath_change_percentage:
            type:
              - number
              - 'null'
            description: All-time high change percentage
          ath_date:
            type:
              - string
              - 'null'
            format: date-time
            description: All-time high date
          atl:
            type:
              - number
              - 'null'
            description: All-time low price in target currency
          atl_change_percentage:
            type:
              - number
              - 'null'
            description: All-time low change percentage
          atl_date:
            type:
              - string
              - 'null'
            format: date-time
            description: All-time low date
          roi:
            type:
              - object
              - 'null'
            description: Return on investment data
            properties:
              times:
                type: number
                description: ROI multiplier
              currency:
                type: string
                description: ROI currency
              percentage:
                type: number
                description: ROI percentage
          last_updated:
            type: string
            format: date-time
            description: Last updated timestamp
          market_cap_rank_with_rehypothecated:
            type:
              - integer
              - 'null'
            description: Market cap rank including rehypothecated tokens
          sparkline_in_7d:
            type: object
            description: Sparkline price data for the last 7 days
            properties:
              price:
                type: array
                items:
                  type: number
                description: Array of price values
          price_change_percentage_1h_in_currency:
            type:
              - number
              - 'null'
            description: 1-hour price change percentage in target currency
          price_change_percentage_24h_in_currency:
            type:
              - number
              - 'null'
            description: 24-hour price change percentage in target currency
          price_change_percentage_7d_in_currency:
            type:
              - number
              - 'null'
            description: 7-day price change percentage in target currency
          price_change_percentage_14d_in_currency:
            type:
              - number
              - 'null'
            description: 14-day price change percentage in target currency
          price_change_percentage_30d_in_currency:
            type:
              - number
              - 'null'
            description: 30-day price change percentage in target currency
          price_change_percentage_200d_in_currency:
            type:
              - number
              - 'null'
            description: 200-day price change percentage in target currency
          price_change_percentage_1y_in_currency:
            type:
              - number
              - 'null'
            description: 1-year price change percentage in target currency
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.