Coin rankings

Query crypto rankings for CEX and DEX assets, sorted by metrics such as 24-hour trading volume.

GET/api/v1/markets/rankings
Domain
Market & Liquidity
Level
Aggregate
MCP tool
market_data_query (task=rankings)

Available data

Returns
Query crypto rankings for CEX and DEX assets, sorted by metrics such as 24-hour trading volume
What each request returns
Set ranking_type to choose a coin board.

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

ranking_typestringqueryExamplemarket_pulse_hotrequired

Ranking type · popular / top_gainers / top_losers / twitter_hot / airdrop / new_listing / market_pulse_hot

time_rangestringqueryoptional

Gainers and losers window · 1h / 24h / 7d

listing_querystringqueryoptional

Exchange or keyword for new listings

listing_fromintegerqueryoptional

New-listing start time (Unix seconds)

listing_tickersstringqueryoptional

Comma-separated new-listing symbols

venue_typestringqueryoptional

Venue type · cex / dex · Default: cex

market_typestringqueryoptional

Spot or perpetual market · spot / perp · Default: spot

chainstringqueryoptional

Blockchain · Default: all

periodstringqueryoptional

Query window · Default: 1h

offsetintegerqueryExample0optional

Rows to skip · Default: 0 · ≥ 0

languagestringqueryoptional

Ranking language · Default: zh_CN

supported_chains_onlybooleanqueryoptional

Restrict to supported chains · Default: false

candidate_filterstringqueryoptional

Token candidate filter · token_holders

orderstringqueryoptional

Sort order · asc / desc · Default: desc

limitintegerqueryExample1optional

Maximum rows · Default: 20 · ≤ 100

sort_bystringqueryoptional

Sort field

quotestringqueryoptional

Quote asset filter

marketstringqueryExamplecryptooptional

Market code; derivatives currently serve crypto only. · crypto

Response

countnumber

Returned row count

data_statusDataStatus

Data status

ranking_typestring

Ranking type

totalnumber

Total matching records

items[]object[]

Result rows

chainstring

Blockchain

namestring

Name

symbolstring

Asset symbol

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.