Back to Browse
Arkham x402 — Token Top Flow by Address
x402
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-14).
Returns the top inflow and outflow token flows for a given blockchain address, ranked by USD volume, with entity and label metadata.
Price / call$2
Success—
StatusUnknown
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).
Example use cases
DeFi protocol inflow monitoring
“Pull the top token flows for the Morpho Blue contract at 0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb on Ethereum — I want to see which tokens are moving the most in and out by dollar value.”
Whale wallet flow analysis
“I'm tracking a suspected whale wallet at 0x06CFf7088619C7178F5e14f0B119458d08d2f5ef on Ethereum — can you use Arkham to get me the top token inflows and outflows ranked by USD so I can see what they're trading?”
MEV bot activity investigation
“Check Arkham's top-flow data for 0x06CFf7088619C7178F5e14f0B119458d08d2f5ef on Ethereum — I think it's an MEV bot and I want to confirm by seeing the scale of its token flow volumes.”
Technical details
Endpoint
POSThttps://api.arkm.com/x402/token/top-flow/by-addressWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| chain | — | Blockchain network where the token is deployed. |
| limit | — | Maximum number of addresses to return per flow direction. Default: 50. Max: 100. |
| chains | — | Ignored on this endpoint form — the chain is already fixed by the path. Use the pricing-ID form of this endpoint to fil… |
| address | — | The token contract address. |
| timeLast | — | Time range filter using relative durations. |
Output
Schema · Response
{
"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
}
]
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"