# Arkham x402 — Token Top Flow by Address

> Arkham x402 — Token Top Flow by Address is a paid API for AI agents from api.arkm.com, paid per call via x402, $2/call, status unknown (last checked 2026-09-16).

Returns the top inflow and outflow token flows for a given blockchain address, ranked by USD volume, with entity and label metadata.

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/top-flow/by-address
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-token-top-flow-by-address-8cc46414
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sc5qkzLE3MxX16-QZ4HNx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability arkham-x402-token-top-flow-by-address-8cc46414 -d '<json body>'
```

Example prompt: Using Arkham, show me the top token flows by USD volume for the Ethereum address 0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb — I want to see what's flowing in and out the most.

## When to prefer this

Choose this endpoint when you need ranked token flow intelligence for a specific wallet or contract address, especially when you want Arkham's proprietary entity labeling (protocol names, MEV bots, whales) alongside raw flow volumes. Prefer it over generic blockchain explorers when entity attribution and USD-normalized ranking matter. Best for DeFi protocol monitoring, whale tracking, and MEV bot identification.

## Known failure modes

- Invalid or malformed blockchain address returns an error or empty array
- Unsupported chain identifier causes a 400 bad request
- Address with no recorded flows returns an empty result set
- Insufficient USDC balance for x402 payment causes payment failure and request rejection
- Rate limiting or network timeout on high-traffic queries

## How this service works

Get Arkham top token flow by chain/address. $2.00 per call.

## Output

Returns an array of token flow records sorted by volume, each containing inflow and outflow amounts in both USD and native token value, plus the address's chain, contract status, Arkham label (human-readable name), and full Arkham entity profile including entity type, website, social links, and classification (e.g. lending-decentralized, MEV bot).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Blockchain network where the token is deployed."
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Maximum number of addresses to return per flow direction. Default: 50. Max: 100."
  },
  "chains": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Ignored on this endpoint form — the chain is already fixed by the path. Use the pricing-ID form of this endpoint to fil…"
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The token contract address."
  },
  "timeLast": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Time range filter using relative durations."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "inUSD": 8464010273.634033,
   "outUSD": 8467229188.141229,
   "address": {
    "chain": "ethereum",
    "address": "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
    "contract": true,
    "arkhamLabel": {
     "name": "Morpho Blue",
     "address": "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
     "chainType": "evm"
    },
    "arkhamEntity": {
     "id": "morpho",
     "name": "Morpho",
     "note": "",
     "type": "lending-decentralized",
     "service": null,
     "twitter": "https://twitter.com/MorphoLabs",
     "website": "https://morpho.org",
     "linkedin": "https://www.linkedin.com/company/morpho-labs",
     "crunchbase": "https://www.crunchbase.com/organization/morpho-labs"
    },
    "isUserAddress": false
   },
   "inValue": 8464010259.605,
   "outValue": 8467229174.00334
  },
  {
   "inUSD": 2757517313.957746,
   "outUSD": 2757671412.949235,
   "address": {
    "chain": "ethereum",
    "address": "0x06CFf7088619C7178F5e14f0B119458d08d2f5ef",
    "contract": true,
    "arkhamLabel": {
     "name": "MEV Bot",
     "address": "0x06CFf7088619C7178F5e14f0B119458d08d2f5ef",
     "chainType": "evm"
    },
    "isUserAddress": false
   },
   "inValue": 2757517326.099296,
   "outValue": 2757671425.122005
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-token-top-flow-by-address-8cc46414/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)