# Get top token flow

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.

Endpoint: GET /token/top_flow/{chain}/{address}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `chain` (string, required)
    The blockchain chain (e.g., ethereum, bitcoin).

  - `address` (string, required)
    The token address or holder address.

## Query parameters:

  - `timeLast` (string, required)
    Duration string representing the time window (e.g., "24h", "7d").

  - `id` (string, required)
    pricingID of a token, e.g. "arkham"

## Response 200 fields (application/json):

  - `address` (object)
    Blockchain address intelligence object

  - `address.address` (string)
    The raw address (hex for EVM chains, base58 for Bitcoin, etc.)
    Example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

  - `address.chain` (string)
    Enum: "ethereum", "polygon", "bsc", "optimism", "avalanche", "arbitrum_one", "bitcoin", "tron", "base", "flare", "linea", "manta", "blast", "ton", "solana", "mantle", "dogecoin", "sonic"

  - `address.depositServiceID` (string,null)

  - `address.arkhamEntity` (object,null)

  - `address.arkhamEntity.name` (string,null)
    Example: "Vitalik Buterin"

  - `address.arkhamEntity.note` (string,null)

  - `address.arkhamEntity.id` (string,null)
    Example: "vitalik-buterin"

  - `address.arkhamEntity.type` (string,null)
    Example: "individual"

  - `address.arkhamEntity.service` (string,null)

  - `address.arkhamEntity.addresses` (string,null)

  - `address.arkhamEntity.website` (string,null)

  - `address.arkhamEntity.twitter` (string,null)
    Example: "https://twitter.com/VitalikButerin"

  - `address.arkhamEntity.crunchbase` (string,null)
    Example: "https://www.crunchbase.com/person/vitalik-buterin"

  - `address.arkhamEntity.linkedin` (string,null)
    Example: "https://www.linkedin.com/in/vitalik-buterin-267a7450"

  - `address.arkhamLabel` (object,null)

  - `address.arkhamLabel.address` (string,null)
    Example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

  - `address.arkhamLabel.chainType` (string)
    Enum: "evm", "bitcoin", "tron", "ton", "solana", "dogecoin"

  - `address.isUserAddress` (boolean,null)

  - `address.contract` (boolean,null)

  - `inUSD` (number,null)
    Example: 8337419.937040014

  - `outUSD` (number,null)
    Example: 8300701.09322816

  - `inValue` (number,null)
    Example: 1941.1915603221187

  - `outValue` (number,null)
    Example: 1932.6267573327154

## Response 400 fields (application/json):

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

## Response 401 fields (application/json):

  - `error` (string)
    Example: "API key missing or invalid"


## Response 500 fields