Skip to main content
GET
币种市场
一次调用返回覆盖多个币种的排名行情表:每个币种一行,包含 current_pricemarket_capmarket_cap_ranktotal_volumehigh_24hlow_24hprice_change_percentage_24hcirculating_supplytotal_supplymax_supply、带日期的 athatl,以及 image。用 per_pagepage 分页,用 order 排序(按市值、成交量或 id,升序或降序),用 idscategory 收窄范围。传入 price_change_percentage 会额外返回对应的 price_change_percentage_24h_in_currency 字段。适合用于榜单和板块扫描。如果只需要少数已知币种的价格,get_coingecko_simple_price 更轻量;如需某一币种的完整信息,请使用 get_coingecko_coins_id

授权

Authorization
string
header
必填

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

查询参数

vs_currency
string
默认值:usd
必填

价格的目标货币(例如 usdeurbtc)。请参阅 /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

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

precision
string

使用 full018 之间的值指定货币价格值的小数位数。

include_rehypothecated
boolean
默认值:false

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

响应

200 - application/json

加密货币市场条目数组。