代币榜单

查询 Crypto 行情榜单,支持按 24 小时成交量等指标排序。

GET/api/v1/markets/rankings
数据域
行情与流动性
解析层级
汇总
MCP 工具
market_data_query (task=rankings)

可查询数据

返回数据
查询 Crypto 行情榜单,支持按 24 小时成交量等指标排序
每次返回什么
指定榜单类型时按该榜单查询。

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

ranking_typestringquery示例market_pulse_hot必填

榜单类型 · popular / top_gainers / top_losers / twitter_hot / airdrop / new_listing / market_pulse_hot

time_rangestringquery可选

涨跌幅榜统计区间 · 1h / 24h / 7d

listing_querystringquery可选

新上币榜的交易所或关键词

listing_fromintegerquery可选

新上币起始时间(Unix 秒)

listing_tickersstringquery可选

逗号分隔的新上币代码

venue_typestringquery可选

交易场所类型 · cex / dex · 默认: cex

market_typestringquery可选

现货或永续合约 · spot / perp · 默认: spot

chainstringquery可选

所属链 · 默认: all

periodstringquery可选

查询时间范围 · 默认: 1h

offsetintegerquery示例0可选

跳过的记录数 · 默认: 0 · ≥ 0

languagestringquery可选

榜单语言 · 默认: zh_CN

supported_chains_onlybooleanquery可选

仅查询支持的链 · 默认: false

candidate_filterstringquery可选

候选代币筛选方式 · token_holders

orderstringquery可选

排序方向 · asc / desc · 默认: desc

limitintegerquery示例1可选

最多返回条数 · 默认: 20 · ≤ 100

sort_bystringquery可选

排序字段

quotestringquery可选

计价资产筛选

marketstringquery示例crypto可选

市场代码;衍生品当前仅覆盖 crypto。 · crypto

响应

countnumber

本次返回条数

data_statusDataStatus

数据状态

ranking_typestring

榜单类型

totalnumber

匹配记录总数

items[]object[]

结果列表

chainstring

所属链

namestring

名称

symbolstring

资产代码

错误与降级

200
assets_resolve 名称多命中;从 data[] 候选确认。
200
对象已解析但无可用数据;empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效,或行情 listing 多命中;歧义响应含 required_params + candidates。
401
缺少 API Key,或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在;数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限;body 返回 retry_after,响应头同步返回 Retry-After。