Crypto Token Leaderboard (by Market Cap, 24h Change, or Volume)

{
  "type": "object",
  "required": [
    "sort_by"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Example: 20. Defaults to 20."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort order: desc (default, highest first) or asc (lowest first). Example: desc. Defaults to \"desc\"."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. Example: 0. Defaults to 0."
    },
    "sort_by": {
      "enum": [
        "market_cap",
        "change_24h",
        "volume_24h"
      ],
      "type": "string",
      "description": "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."
    },
    "category": {
      "enum": [
        "MEME",
        "AI",
        "AI_AGENTS",
        "L1",
        "L2",
        "DEFI",
        "GAMING",
        "STABLECOIN",
        "RWA",
        "DEPIN",
        "SOL_ECO",
        "BASE_ECO",
        "LST"
      ],
      "type": "string",
      "description": "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."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "rank",
          "symbol",
          "name",
          "price_usd"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The provider's internal catalog id for the token (a UUID), not a phone number or other contact value."
          },
          "ath": {
            "type": "number",
            "description": "All-time high price, USD."
          },
          "atl": {
            "type": "number",
            "description": "All-time low price, USD."
          },
          "fdv": {
            "type": "number",
            "description": "Fully diluted valuation, USD."
          },
          "name": {
            "type": "string",
            "description": "The token's public display name, e.g. 'Bitcoin' -- not a person's name."
          },
          "rank": {
            "type": "integer",
            "description": "1-based market-cap rank position."
          },
          "slug": {
            "type": "string",
            "description": "URL-safe token slug, e.g. 'bitcoin'."
          },
          "symbol": {
            "type": "string",
            "description": "Ticker symbol, e.g. 'BTC'."
          },
          "low_24h": {
            "type": "number",
            "description": "24h low price, USD. Observed as 0 on at least one real fixture entry (a thinly-traded token), so 0 is not a sentinel for missing data."
          },
          "ath_date": {
            "type": "integer",
            "description": "Unix timestamp (seconds) of the all-time high."
          },
          "atl_date": {
            "type": "integer",
            "description": "Unix timestamp (seconds) of the all-time low."
          },
          "high_24h": {
            "type": "number",
            "description": "24h high price, USD. Observed as 0 on at least one real fixture entry (a thinly-traded token), so 0 is not a sentinel for missing data."
          },
          "price_usd": {
            "type": "number"
          },
          "max_supply": {
            "type": "number",
            "description": "Only present on tokens with a hard-capped supply (e.g. Bitcoin); absent entirely on uncapped tokens observed in the real fixture (e.g. Ethereum, Tether)."
          },
          "total_supply": {
            "type": "number"
          },
          "change_24h_pct": {
            "type": "number",
            "description": "24-hour price change, percent."
          },
          "market_cap_usd": {
            "type": "number"
          },
          "volume_24h_usd": {
            "type": "number"
          },
          "circulating_supply": {
            "type": "number"
          }
        },
        "additionalProperties": true
      },
      "description": "The ranked page of tokens. Empty when `offset` is past the end of the list."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer"
        },
        "cached": {
          "type": "boolean"
        },
        "offset": {
          "type": "integer"
        },
        "has_more": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    }
  },
  "description": "A page of ranked tokens plus pagination metadata, as returned at $.output.",
  "additionalProperties": true
}