ASasksurf
Market

Token Rankings

Returns a token leaderboard sorted by market cap, 24h change, or volume. Each entry includes price, market cap, FDV, supply, ATH/ATL, and 24h range. Supports category filtering (MEME, AI, L1, L2, DEFI, GAMING, etc.).

Available metrics: market_cap, top_gainers, top_losers, volume.

Note: top_gainers and top_losers rank by 24h price change within the top 250 coins by market cap.

For circulating supply, FDV, ATH/ATL, use /project/detail?fields=token_info.

get/gateway/v1/market/ranking

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

sort_by'market_cap' | 'change_24h' | 'volume_24h'

Field to sort by. market_cap sorts by total market capitalisation, change_24h sorts by 24-hour price change percentage (fetches top 250 by market cap then sorts client-side), volume_24h sorts by 24-hour trading volume.

Example:market_cap
order'asc' | 'desc'

Sort order: desc (default, highest first) or asc (lowest first).

Example:desc
category'MEME' | 'AI' | 'AI_AGENTS' | 'L1' | 'L2' | 'DEFI' | 'GAMING' | 'STABLECOIN' | 'RWA' | 'DEPIN' | 'SOL_ECO' | 'BASE_ECO' | 'LST'

Optional token category filter. When provided, results are limited to coins in that category. Supported values: MEME, AI, AI_AGENTS, L1, L2, DEFI, GAMING, STABLECOIN, RWA, DEPIN, SOL_ECO, BASE_ECO, LST.

Example:MEME
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseMarketTopCoinItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.