# GET /token/top_flow/{chain}/{address}

**Operation ID:** `GetTopTokenFlowByChainAddress`

Get top token flow

Retrieves the top token flow (in USD and value) for the specified chain and address over a given duration.

Only chains with token contracts (EVM chains, Solana, Tron) return token flows here. For UTXO assets like Bitcoin, use the pricing-ID form (/token/top_flow/{id}) for native flows.

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

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `timeLast` | query | string | Yes | Time range filter using relative durations. Example: `"24h"` |
| `limit` | query | integer | No | Maximum number of addresses to return per flow direction. Default: 50. Max: 100. Example: `5` |
| `chains` | query | array | No | Ignored on this endpoint form — the chain is already fixed by the path. Use the pricing-ID form of this endpoint to filter flows by chain. Example: `["ethereum","bsc","polygon"]` |
| `chain` | path | string | Yes | Blockchain network where the token is deployed. Example: `"ethereum"` |
| `address` | path | string | Yes | The token contract address. Example: `"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"` |

## Responses

- **200**: OK
  **Schema**: (array)
    - **(items)**: ([TopFlow](https://arkm.com/llms/schemas/TopFlow.md))
- **400**: Bad Request
- **500**: Internal Server Error

## Example

```bash
curl -X GET "https://api.arkm.com/token/top_flow/ethereum/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?timeLast=24h&limit=5&chains=ethereum,bsc,polygon" \
  -H "API-Key: YOUR_API_KEY"
```
