> ## 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 (ID Map)

> The full id/symbol/name map for every listed coin — resolve a ticker into the CoinGecko id other endpoints require.

The full CoinGecko identifier map: every listed coin as `id`, `symbol` and `name`. Use it once to resolve a ticker into the `id` that every other CoinGecko tool requires — `bitcoin`, not BTC. Set `include_platform` to also get each coin's contract address per chain. Mind the size: this returns roughly 18,000 entries and takes several seconds, so cache it instead of calling it per lookup. If you already know the ids and only want numbers, call [`get_coingecko_simple_price`](/docs/api-reference/coingecko/get_coingecko-simple-price) directly; to identify a coin from a contract address instead, use [`get_coingecko_token_data`](/docs/api-reference/coingecko/get_coingecko-coins-id-contract-contract-address).


## OpenAPI

````yaml openapi/coingecko.json GET /coingecko/coins/list
openapi: 3.0.3
info:
  title: CoinGecko API
  version: 1.0.0
  description: >-
    CoinGecko crypto market data routed through the AIsa gateway. Covers coin
    metadata, live and historical prices, OHLC, exchanges, tickers, categories,
    and trending search. Proxies the public CoinGecko v3 API at
    `https://api.coingecko.com/api/v3/`.
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /coingecko/coins/list:
    get:
      summary: Coins List (ID Map)
      description: >-
        The full CoinGecko identifier map: every listed coin as `id`, `symbol`
        and `name`. Use it once to resolve a ticker into the `id` that every
        other CoinGecko tool requires — `bitcoin`, not BTC. Set
        `include_platform` to also get each coin's contract address per chain.
        Mind the size: this returns roughly 18,000 entries and takes several
        seconds, so cache it instead of calling it per lookup. If you already
        know the ids and only want numbers, call `get_coingecko_simple_price`
        directly; to identify a coin from a contract address instead, use
        `get_coingecko_token_data`.
      operationId: get_coingecko_coins_list
      parameters:
        - name: include_platform
          in: query
          description: Include platform + contract addresses.
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Array of coins.
          content:
            application/json:
              example:
                - id: bitcoin
                  symbol: btc
                  name: Bitcoin
                - id: ethereum
                  symbol: eth
                  name: Ethereum
              schema:
                $ref: '#/components/schemas/CoinGeckoObjectArray'
components:
  schemas:
    CoinGeckoObjectArray:
      type: array
      items:
        type: object
        additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key

````