> ## 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.

# 按 ID 获取币种数据

> CoinGecko 收录的某个币种的全部信息：档案、链接、板块、合约地址和完整行情数据。

按 `id` 返回 CoinGecko 收录的某个币种的全部信息：`description`、`links`、`image`、`categories`、`platforms` 和 `detail_platforms`（各链上的合约地址）、`market_cap_rank`，以及包含 `current_price`、`market_cap`、`total_volume`、`fully_diluted_valuation`、`ath` 和 `atl`（含日期和涨跌幅）的 `market_data` 区块。体量较大的部分通过 `market_data`、`community_data`、`developer_data`、`tickers`、`sparkline` 和 `localization` 按需开启——除非确实需要，否则请保持关闭，完整响应体很大。适合用于获取币种档案。如需跨多个币种的价格表，请使用 [`get_coingecko_coins_markets`](/docs/zh/api-reference/coingecko/get_coingecko-coins-markets)；如需按合约地址查询同一币种，请使用 [`get_coingecko_token_data`](/docs/zh/api-reference/coingecko/get_coingecko-coins-id-contract-contract-address)。

<Note>
  **第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
  Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
  Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
  [aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
</Note>

[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/coingecko/get_coingecko-coins-id)


## OpenAPI

````yaml openapi/zh/coingecko.json GET /coingecko/coins/{id}
openapi: 3.0.3
info:
  title: CoinGecko API
  version: 1.0.0
  description: >-
    通过 AIsa 网关路由的 CoinGecko 加密货币市场数据。涵盖代币元数据、实时和历史价格、OHLC、交易所、行情代码、类别及热门搜索。代理位于
    `https://api.coingecko.com/api/v3/` 的公共 CoinGecko v3 API。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /coingecko/coins/{id}:
    get:
      summary: 按 ID 获取币种数据
      description: >-
        按 `id` 返回 CoinGecko
        收录的某个币种的全部信息：`description`、`links`、`image`、`categories`、`platforms` 和
        `detail_platforms`（各链上的合约地址）、`market_cap_rank`，以及包含
        `current_price`、`market_cap`、`total_volume`、`fully_diluted_valuation`、`ath`
        和 `atl`（含日期和涨跌幅）的 `market_data` 区块。体量较大的部分通过
        `market_data`、`community_data`、`developer_data`、`tickers`、`sparkline` 和
        `localization` 按需开启——除非确实需要，否则请保持关闭，完整响应体很大。适合用于获取币种档案。如需跨多个币种的价格表，请使用
        `get_coingecko_coins_markets`；如需按合约地址查询同一币种，请使用
        `get_coingecko_token_data`。
      operationId: get_coingecko_coins_id
      parameters:
        - $ref: '#/components/parameters/CoinId'
        - name: localization
          in: query
          schema:
            type: boolean
            default: true
        - name: tickers
          in: query
          schema:
            type: boolean
            default: true
        - name: market_data
          in: query
          schema:
            type: boolean
            default: true
        - name: community_data
          in: query
          schema:
            type: boolean
            default: true
        - name: developer_data
          in: query
          schema:
            type: boolean
            default: true
        - name: sparkline
          in: query
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: 币种对象。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CoinGeckoObject'
components:
  parameters:
    CoinId:
      name: id
      in: path
      required: true
      description: CoinGecko 代币 ID（例如 `bitcoin`、`ethereum`）。通过 `/coins/list` 获取列表。
      schema:
        type: string
      example: bitcoin
  schemas:
    CoinGeckoObject:
      type: object
      additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key

````

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