加密货币行情 API

比特币、以太坊等加密货币价格与市值排行（可选配置 COINGECKO_API_KEY 提高限额）

数据来源：CoinGecko

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

查询指定币种价格、24h 涨跌、市值

GET /api/crypto/price

请求参数

  • ids（必填）：CoinGecko 币种 id，逗号分隔（最多 50 个），示例 bitcoin,ethereum
  • vs：计价货币，逗号分隔，示例 usd,cny

返回字段

  • coins（array）：查到的币种，按请求参数 ids 的顺序排列；没查到的 id 不在其中，见 notFound
  • coins[].id（string）：CoinGecko 币种 id（如 bitcoin、ethereum）
  • coins[].prices（object）：按计价货币分组的行情，键为小写计价货币代码（与参数 vs 对应，如 usd、cny）；上游不支持的计价货币不会出现
  • coins[].prices.*（object）：以该计价货币计价的行情（如 prices.usd 以美元计，prices.cny 以人民币元计）
  • coins[].prices.*.price（number|null）：1 枚币的价格，单位为该计价货币；上游值不是有效数字时为 null
  • coins[].prices.*.marketCap（number|null）：总市值，单位为该计价货币；上游无数据时为 null
  • coins[].prices.*.volume24h（number|null）：近 24 小时成交额（不是成交币数），单位为该计价货币；上游无数据时为 null
  • coins[].prices.*.changePercent24h（number|null）：近 24 小时涨跌幅，百分数（1.23 表示 +1.23%，负数表示下跌）；上游无数据时为 null
  • coins[].updatedAt（string|null）：上游价格的最后更新时间（ISO 8601，UTC）；上游未提供时为 null
  • notFound（array）：CoinGecko 没有返回数据的币种 id（字符串数组，通常是 id 拼写错误或不存在）；都查到时为空数组

按市值排行的币种列表

GET /api/crypto/markets

请求参数

  • vs：计价货币，示例 cny
  • limit：条数（1~100）
  • page：页码

返回字段

  • [].id（string）：CoinGecko 币种 id，可用作 /api/crypto/price 的 ids 参数。列表按市值从大到小排序
  • [].symbol（string|null）：币种符号，已转为大写（如 BTC、ETH）；上游缺失时为 null
  • [].name（string）：币种英文名称（如 Bitcoin）
  • [].image（string|null）：币种图标图片 URL；上游缺失时为 null
  • [].rank（number|null）：市值排名（1 为市值最大）；上游无排名时为 null
  • [].price（number|null）：当前价格，单位为参数 vs 指定的计价货币（默认 usd 即美元；vs=cny 时为人民币元，下同）；上游缺失时为 null
  • [].marketCap（number|null）：总市值（计价货币）；上游缺失时为 null
  • [].volume24h（number|null）：近 24 小时成交额（计价货币，不是成交币数）；上游缺失时为 null
  • [].high24h（number|null）：近 24 小时最高价（计价货币）；上游缺失时为 null
  • [].low24h（number|null）：近 24 小时最低价（计价货币）；上游缺失时为 null
  • [].priceChange24h（number|null）：近 24 小时价格涨跌额（计价货币，如 773.45 表示每枚上涨 773.45 美元，负数表示下跌）；上游缺失时为 null
  • [].changePercent24h（number|null）：近 24 小时涨跌幅，百分数（1.23 表示 +1.23%）；上游缺失时为 null
  • [].circulatingSupply（number|null）：流通量（枚）；上游缺失时为 null
  • [].totalSupply（number|null）：总供应量（枚）；上游缺失时为 null
  • [].maxSupply（number|null）：最大供应量（枚）；没有供应上限（如 ETH）或上游缺失时为 null
  • [].ath（number|null）：历史最高价（计价货币）；上游缺失时为 null
  • [].athDate（string|null）：创下历史最高价的时间（ISO 8601，UTC）；上游缺失时为 null
  • [].updatedAt（string|null）：上游数据的最后更新时间（ISO 8601，UTC）；上游缺失时为 null