# Token

Provides endpoints for retrieving token-related information, including holders, flows, volumes, trending tokens, and balances across chains. These endpoints allow analysis of token distribution, trading activity, and ownership at both entity and address levels.

## Get top token holders by pricing ID

 - [GET /token/holders/{pricing_id}](https://docs.intel.arkm.com/openapi/token/gettoptokenholders.md): Returns top token holders for the token identified by its CoinGecko pricing ID.

## Get top token holders by chain and address

 - [GET /token/holders/{chain}/{address}](https://docs.intel.arkm.com/openapi/token/gettoptokenholdersbychainandaddress.md): Returns top token holders for the token at the specified contract address on the given chain.

## Get trending tokens

 - [GET /token/trending](https://docs.intel.arkm.com/openapi/token/gettrendingtokens.md): Returns a list of currently trending tokens across multiple chains.

## Get a single trending token by ID

 - [GET /token/trending/{id}](https://docs.intel.arkm.com/openapi/token/gettrendingtoken.md): Returns a single trending token, identified by a specific ID (e.g., "bitcoin", "ethereum").

## Get top flow for a token by pricing ID

 - [GET /token/top_flow/{id}](https://docs.intel.arkm.com/openapi/token/gettokentopflow.md): Returns the top inflows/outflows for the specified token ID, aggregated by address. Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

## Get top token flow

 - [GET /token/top_flow/{chain}/{address}](https://docs.intel.arkm.com/openapi/token/gettokentopflowbychain.md): Retrieves the top token flow (in USD and value) for the specified chain and address over a given duration.

Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

Filter parameters:
- chain: The blockchain chain identifier (e.g., ethereum, bitcoin).
- address: The token address or holder address.
- timeLast: A duration string (e.g., "24h", "7d") representing the time window to consider.
- chains (optional): Comma-separated list of chains to further filter the results.

## Get volume for a token by pricing ID

 - [GET /token/volume/{id}](https://docs.intel.arkm.com/openapi/token/gettokenvolume.md): Returns aggregated volume data for the specified token ID, optionally broken down by time granularity. Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

## Get volume for a token by chain/address

 - [GET /token/volume/{chain}/{address}](https://docs.intel.arkm.com/openapi/token/gettokenvolumebychain.md): Returns aggregated volume data for the specified token contract on a certain chain. Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

## Get token balance (all chains) for an entity or address

 - [GET /token/balance/{id}](https://docs.intel.arkm.com/openapi/token/gettokenbalance.md): Returns the aggregated token balance for either an entity or address, across all chains.

## Get token balance for an entity or address, for a specific chain/address

 - [GET /token/balance/{chain}/{address}](https://docs.intel.arkm.com/openapi/token/gettokenbalancebychain.md): Returns the aggregated token balance for either an entity or address, across all chains, but identified by the specific token contract.