代币榜单
查询 Crypto 行情榜单,支持按 24 小时成交量等指标排序。
GET/api/v1/markets/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。