# Retrieves a ranked list of tokens based on trading volume, inflows, outflows, netflows, price, or other metrics over a specified time interval. Results can be sorted, filtered by chain, market cap, or token ID, and paginated for flexible queries.

Retrieves a list of top tokens based on various query filters.

Filter parameters:
- timeframe: Required time interval for token data. Valid values: "1h", "6h", "12h", "24h", "7d".
- orderByAgg: Aggregation field to order tokens by.
Valid values: "volume", "inflow", "outflow", "volumeDex", "volumeCex", "inflowDex", "inflowCex", "outflowDex", "outflowCex", "netflowDex", "netflowCex", "netflow", "netflowVolumeRatio", "netflowVolumeRatioDex", "netflowVolumeRatioCex", "price".
- orderByDesc: Sorting direction. Must be "true" for descending or "false" for ascending.
- orderByPercent: Whether to order results by percentage change. Must be "true" or "false".
- from: Starting index for pagination.
- size: Number of results to return.
- chains: Comma-separated list of blockchain chains (e.g., "ethereum,bsc").
- minVolume: Minimum trading volume (float; default is 0).
- maxVolume: Maximum trading volume (float; optional).
- minMarketCap: Minimum market capitalization (float; default is 0).
- maxMarketCap: Maximum market capitalization (float; optional).
- numReferencePeriods: Number of reference periods, defaults to "auto".
- tokenIds: Comma-separated list of token IDs to filter by (optional).

Endpoint: GET /token/top
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `timeframe` (string, required)
    Time interval for token data.
    Enum: "1h", "6h", "12h", "24h", "7d"

  - `orderByAgg` (string, required)
    Aggregation field to order tokens by.
    Enum: "volume", "inflow", "outflow", "volumeDex", "volumeCex", "inflowDex", "inflowCex", "outflowDex", "outflowCex", "netflowDex", "netflowCex", "netflow", "netflowVolumeRatio", "netflowVolumeRatioDex", "netflowVolumeRatioCex", "price"

  - `orderByDesc` (string, required)
    Sorting direction flag. Use "true" for descending, "false" for ascending.
    Enum: "true", "false"

  - `orderByPercent` (string, required)
    Whether to order results by percentage change.
    Enum: "true", "false"

  - `from` (integer, required)
    Starting index for pagination.

  - `size` (integer, required)
    Number of results to return.

  - `chains` (string)
    Comma-separated list of blockchain chains (e.g., "ethereum,bsc").

  - `minVolume` (number)
    Minimum volume filter.

  - `maxVolume` (number)
    Maximum volume filter.

  - `minMarketCap` (number)
    Minimum market capitalization filter.

  - `maxMarketCap` (number)
    Maximum market capitalization filter.

  - `numReferencePeriods` (string)
    Number of reference periods (default "auto").

  - `tokenIds` (string)

## Response 200 fields (application/json):

  - `tokens` (array)

  - `tokens.token` (object)

  - `tokens.token.id` (string)
    Example: "arkham"

  - `tokens.token.symbol` (string)
    Example: "arkm"

  - `tokens.token.marketCap` (number,null)
    Example: 266713684.866522

  - `tokens.current` (object)

  - `tokens.current.price` (number)
    Example: 0.579717

  - `tokens.current.inflowDexVolume` (number)
    Example: 3954413.773988366

  - `tokens.current.inflowCexVolume` (number)
    Example: 835149.3657948226

  - `tokens.current.outflowDexVolume` (number)
    Example: 835232.8781155571

  - `tokens.current.outflowCexVolume` (number)
    Example: 22801170.168555997

  - `tokens.previous` (object)

  - `total` (integer)
    Example: 10

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad request"