Skip to main content
GET
币种市场
一次调用返回覆盖多个币种的排名行情表:每个币种一行,包含 current_price、market_cap、market_cap_rank、total_volume、high_24h、low_24h、price_change_percentage_24h、circulating_supply、total_supply、max_supply、带日期的 ath 和 atl,以及 image。用 per_page 和 page 分页,用 order 排序(按市值、成交量或 id,升序或降序),用 ids 或 category 收窄范围。传入 price_change_percentage 会额外返回对应的 price_change_percentage_24h_in_currency 字段。适合用于榜单和板块扫描。如果只需要少数已知币种的价格,get_coingecko_simple_price 更轻量;如需某一币种的完整信息,请使用 get_coingecko_coins_id。
第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

vs_currency
string
默认值:usd
必填

价格的目标货币(例如 usd、eur、btc)。请参阅 /simple/supported_vs_currencies。

ids
string

以逗号分隔的 CoinGecko 代币 ID。

category
string

按类别筛选(参见 /coins/categories/list)。

order
enum<string>
默认值:market_cap_desc
可用选项:
market_cap_desc,
market_cap_asc,
volume_desc,
volume_asc,
id_asc,
id_desc
per_page
integer
默认值:100
必填范围: 1 <= x <= 250
page
integer
默认值:1
sparkline
boolean
默认值:false
price_change_percentage
string

以逗号分隔的时间窗口:1h,24h,7d,14d,30d,200d,1y。

locale
string
默认值:en

响应语言区域设置。官方值包括 en、zh、zh-tw 以及 CoinGecko 支持的其他区域设置。

precision
string

使用 full 或 0 到 18 之间的值指定货币价格值的小数位数。

include_rehypothecated
boolean
默认值:false

在 CoinGecko 支持时,将再质押词元纳入市场数据。

响应

200 - application/json

加密货币市场条目数组。