{"uid":"cap_sc5qkzLE3MxX16-QZ4HNx","slug":"arkham-x402-token-top-flow-by-address-8cc46414","name":"Arkham x402 — Token Top Flow by Address","description":"Get Arkham top token flow by chain/address. $2.00 per call.","url":"https://api.arkm.com/x402/token/top-flow/by-address","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RwGIYzUeZDI662-ruvnT-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top inflow and outflow token flows for a given blockchain address, ranked by USD volume, with entity and label metadata.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"DeFi protocol inflow monitoring","prompt":"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."},{"title":"Whale wallet flow analysis","prompt":"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?"},{"title":"MEV bot activity investigation","prompt":"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."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:26.591Z","isFirstParty":false}