{"uid":"cap_sp_MJiDJY9ayD8TsbGQli","slug":"arkham-token-top-flow-by-id-cd300e8a","name":"Arkham Token Top Flow by ID","description":"Get Arkham top token flow by pricing ID. $2.00 per call.","url":"https://api.arkm.com/x402/token/top-flow/by-id","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The CoinGecko pricing ID of the token."},"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":"Chains to filter by, as a single comma-separated string, e.g. 'ethereum,bsc' (not a JSON array). If omitted, returns al…"},"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":12979047524.19118,"outUSD":12971777421.73696,"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":12979047525.96132,"outValue":12971777423.62608},{"inUSD":4866908061.438353,"outUSD":4866351186.855593,"address":{"chain":"base","address":"0x61040E143A77F165Ba44543AF4A079F2C809D14b","contract":true,"arkhamLabel":{"name":"Proxy (EIP-1967 Transparent)","address":"0x61040E143A77F165Ba44543AF4A079F2C809D14b","chainType":"evm"},"isUserAddress":false},"inValue":4866908062.542056,"outValue":4866351187.380329}]},"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_OHpOLXApD8v3Es1zf799M","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 addresses for a specific token, ranked by USD volume, with Arkham entity and label metadata.","exampleAgentPrompt":"Pull the top flow addresses for Morpho (by Arkham token ID) on Ethereum — show me which wallets or entities are sending and receiving the most in USD.","exampleUseCases":[{"title":"Whale tracker for DeFi token","prompt":"Which wallets and protocols are seeing the biggest inflows and outflows for the MORPHO token right now? I want to know who the top movers are and whether they're DeFi contracts or individual wallets."},{"title":"Token accumulation signal for trading","prompt":"I'm watching a token and want to know if large entities like funds or protocols are accumulating it — can you pull the top flow addresses for that token by ID from Arkham and show me the USD amounts in and out?"},{"title":"On-chain due diligence for listed token","prompt":"Before I invest, I want to see which known entities are the heaviest flow participants for this token — pull the top inflow and outflow addresses with their Arkham labels so I can see if it's mostly DeFi protocols or unknown wallets."}],"resultDescription":"Returns a ranked list of addresses with their total inflow and outflow values in both USD and native token units, along with chain, contract status, Arkham label (name), and full Arkham entity metadata (entity type, name, Twitter, website, LinkedIn, Crunchbase) where available.","failureModes":["Invalid or unknown token ID returns empty array or 404","Missing or invalid x402 payment header results in 402 Payment Required","Insufficient USDC balance causes payment failure and no data returned","Token with no recorded flows returns empty result set","Rate limiting if too many requests are submitted in rapid succession"],"whenToPreferThis":"Use this endpoint when you need to identify the most active wallet addresses or entities moving a specific token, ranked by USD volume, with rich Arkham entity labels attached. Prefer this over generic on-chain explorers when you need pre-resolved entity metadata (DeFi protocol names, Twitter handles, entity type classifications) rather than raw addresses. Best suited for token-level flow analysis where you want to quickly surface whales, protocols, or institutional participants.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:46.633Z","isFirstParty":false}