{"uid":"cap_98kCnacZjGiTWSCXUqYDG","slug":"arkham-x402-wallet-flow-data-address-7911f3cb","name":"Arkham x402 – Wallet Flow Data (Address)","description":"Get Arkham historical USD flows for an address. $0.40 per call.","url":"https://api.arkm.com/x402/flow/address","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"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 value (e.g. 'ethereum,bsc'). If omitted, returns data across all suppo…"},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The blockchain address to query flow data for."}}},"responseSchema":{"type":"json","example":{"bsc":[{"time":"2023-10-31T00:00:00Z","inflow":99.71,"outflow":0,"cumulativeInflow":91579540.89000005,"cumulativeOutflow":92789860.85},{"time":"2023-12-08T00:00:00Z","inflow":2493652.26,"outflow":0,"cumulativeInflow":91579640.60000002,"cumulativeOutflow":92789860.85}],"ethereum":[{"time":"2023-12-03T00:00:00Z","inflow":523882897.43,"outflow":554928524.09,"cumulativeInflow":1027355003822.289,"cumulativeOutflow":1023262378331.282},{"time":"2023-12-04T00:00:00Z","inflow":1312623236.01,"outflow":1204741283.07,"cumulativeInflow":1027878886719.719,"cumulativeOutflow":1023817306855.372}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","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":"$0.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CPbXe1Z9mAnXo9bp85Q0W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-series inflow and outflow data for a blockchain address across multiple chains, with cumulative totals, via pay-per-request pricing.","exampleAgentPrompt":"Can you pull the full inflow and outflow history for Ethereum address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 across all chains using Arkham's wallet intelligence API?","exampleUseCases":[{"title":"Whale wallet movement monitoring","prompt":"Look up the inflow and outflow history for this wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE on Ethereum and show me how the cumulative balances have changed over the past year."},{"title":"Exchange hot wallet fund tracking","prompt":"I want to see all the capital flows — inflows, outflows, and running totals — for the Binance hot wallet address 0x28C6c06298d514Db089934071355E5743bf21d60 across Ethereum and BSC."},{"title":"DeFi protocol treasury analysis","prompt":"Can you get me the time-series flow data for the Uniswap v3 treasury address on Ethereum so I can see when large amounts moved in or out?"}],"resultDescription":"A JSON object keyed by chain name (e.g. 'ethereum', 'bsc'), each containing an array of time-series records. Each record includes a UTC timestamp, the inflow and outflow amounts for that period, and running cumulative inflow and outflow totals in USD.","failureModes":["Invalid or malformed blockchain address returns an error response","Unsupported chain identifier results in empty or error response","Insufficient USDC balance for x402 payment causes payment failure and no data returned","Address with no on-chain history returns empty arrays per chain","Rate limiting or API key issues cause 401/429 responses"],"whenToPreferThis":"Use this endpoint when you need structured, time-series capital flow data (inflows, outflows, cumulative totals) for a specific blockchain address across multiple chains. It is ideal for tracking whale wallets, exchange hot wallets, protocol treasuries, or any labeled entity in Arkham's intelligence graph. Prefer this over generic block explorers when you need pre-aggregated USD-denominated flow metrics rather than raw transaction lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:26.517Z","isFirstParty":false}