# Token exchange movements

Provides an endpoint for analyzing token activity across centralized and decentralized exchanges. This includes ranking tokens by volume, inflows, outflows, netflows, and other metrics over customizable time intervals, with support for filtering by chain, market cap, and specific tokens.

## 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.

 - [GET /token/top](https://docs.intel.arkm.com/openapi/token-exchange-movements/gettoptokens.md): 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).