Token Rankings

GET /gateway/v1/market/ranking

Token Rankings

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/market/ranking

200

{
  "data": [
    {
      "change_24h_pct": 123,
      "high_24h": 123,
      "low_24h": 123,
      "market_cap_usd": 123,
      "name": "<string>",
      "price_usd": 123,
      "rank": 123,
      "symbol": "<string>",
      "volume_24h_usd": 123,
      "ath": 123,
      "atl": 123,
      "circulating_supply": 123,
      "fdv": 123,
      "image": "<string>",
      "max_supply": 123,
      "total_supply": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseMarketTopCoinItem.json"
}

Query Parameters

sort_by · enum<string> · default: market_cap

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.

Available options: market_cap, change_24h, volume_24h

Example:

"market_cap"

order · enum<string> · default: desc

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

Available options: asc, desc

Example:

"desc"

category · enum<string>

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.

Available options: MEME, AI, AI_AGENTS, L1, L2, DEFI, GAMING, STABLECOIN, RWA, DEPIN, SOL_ECO, BASE_ECO, LST

Example:

"MEME"

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

offset · integer<int64> · default: 0

Pagination offset

Required range: x >= 0

Example:

0

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseMarketTopCoinItem.json"