> ## Documentation Index > Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt > Use this file to discover all available pages before exploring further. # Token Rankings ## OpenAPI ````yaml openapi.json GET /gateway/v1/market/ranking openapi: 3.1.0 info: title: Hermod version: 0.0.1 servers: - url: https://api.asksurf.ai security: [] paths: /gateway/v1/market/ranking: get: tags: - Market summary: Token Rankings description: >- Returns tokens ranked by a specified metric. **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`. operationId: market-ranking parameters: - 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. explode: false in: query name: sort_by schema: default: market_cap 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. enum: - market_cap - change_24h - volume_24h examples: - market_cap type: string - description: 'Sort order: `desc` (default, highest first) or `asc` (lowest first).' explode: false in: query name: order schema: default: desc description: >- Sort order: `desc` (default, highest first) or `asc` (lowest first). enum: - asc - desc examples: - desc 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. explode: false in: query name: category schema: 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. enum: - MEME - AI - AI_AGENTS - L1 - L2 - DEFI - GAMING - STABLECOIN - RWA - DEPIN - SOL_ECO - BASE_ECO - LST examples: - MEME type: string - description: Results per page explode: false in: query name: limit schema: default: 20 description: Results per page examples: - 20 format: int64 maximum: 100 minimum: 1 type: integer - description: Pagination offset explode: false in: query name: offset schema: default: 0 description: Pagination offset examples: - 0 format: int64 minimum: 0 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/DataResponseMarketTopCoinItem' description: OK default: content: application/json: schema: $ref: '#/components/schemas/DataAPIError' description: Error security: - AccessToken: [] components: schemas: DataResponseMarketTopCoinItem: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://example.com/schemas/DataResponseMarketTopCoinItem.json format: uri readOnly: true type: string data: items: $ref: '#/components/schemas/MarketTopCoinItem' type: - array - 'null' meta: $ref: '#/components/schemas/OffsetMeta' required: - data - meta type: object DataAPIError: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://example.com/schemas/DataAPIError.json format: uri readOnly: true type: string error: $ref: '#/components/schemas/DataAPIErrorDetail' required: - error type: object MarketTopCoinItem: additionalProperties: false properties: ath: description: All-time high price in USD format: double type: number atl: description: All-time low price in USD format: double type: number change_24h_pct: description: Price change percentage over the last 24 hours format: double type: number circulating_supply: description: Circulating token supply format: double type: number fdv: description: Fully diluted valuation in USD format: double type: number high_24h: description: Highest price in the last 24 hours in USD format: double type: number image: description: Token logo image URL type: string low_24h: description: Lowest price in the last 24 hours in USD format: double type: number market_cap_usd: description: Total market capitalization in USD format: double type: number max_supply: description: >- Maximum token supply (e.g. 21M for BTC). Not available for all tokens. format: double type: number name: description: Full token name type: string price_usd: description: Current price in USD format: double type: number rank: description: Rank position in the list (1 = highest) format: int64 type: integer symbol: description: Token ticker symbol like `BTC` or `ETH` type: string total_supply: description: Total token supply format: double type: number volume_24h_usd: description: 24-hour trading volume in USD format: double type: number required: - rank - symbol - name - price_usd - change_24h_pct - market_cap_usd - volume_24h_usd - high_24h - low_24h type: object OffsetMeta: additionalProperties: false properties: cached: description: Whether this response was served from cache type: boolean credits_used: description: Credits deducted for this request format: int64 type: integer limit: description: Maximum number of items returned in this response format: int64 type: integer offset: description: Number of items skipped (pagination offset) format: int64 type: integer total: description: >- Total number of matching items (before pagination). Omitted when total is unknown. format: int64 type: integer required: - limit - offset - credits_used - cached type: object DataAPIErrorDetail: additionalProperties: false properties: code: type: string message: type: string required: - code - message type: object ````