{"uid":"cap_Qr3UWA62EOVic6QX9W92r","slug":"arkham-token-volume-by-address-ad8c9012","name":"Arkham Token Volume by Address","description":"Get Arkham token volume by chain/address. $0.60 per call.","url":"https://api.arkm.com/x402/token/volume/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."},"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 to return, as a relative duration such as '24h', '7d', or '60d'. Under 30 days, results honor granularity; 3…"},"granularity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Bucket size for the histogram. Use a whole number of hours, from 1h up to 7d (e.g. 1h, 2h, 6h, 12h, 1d, 2d, 3d, 7d); su…"}}},"responseSchema":{"type":"json","example":[{"time":"2026-07-12T16:00:00Z","inUSD":968891.0319822108,"outUSD":1233415.546442032,"inValue":968891.037339,"outValue":1233415.563605},{"time":"2026-07-12T17:00:00Z","inUSD":1187226.478118926,"outUSD":1275054.663351059,"inValue":1187226.461162,"outValue":1275054.650006}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","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.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_clE6wyalINCpiSgib0aiK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly time-series of token transfer volume (in USD and native token units) flowing into and out of a specific blockchain wallet address.","exampleAgentPrompt":"Pull the hourly token volume for wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE on Arkham — I want to see inflows and outflows in both USD and native token value for the past 48 hours.","exampleUseCases":[{"title":"Whale wallet activity monitoring","prompt":"I want to track how much money is moving in and out of this Ethereum address 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 — can you pull the hourly USD volume for the last 24 hours so I can see if it's been active?"},{"title":"DeFi protocol fund flow analysis","prompt":"Can you get me the hourly token volume data from Arkham for this smart contract address 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D? I need inflows and outflows in USD to understand how much is flowing through it."},{"title":"Crypto investigation due diligence","prompt":"I'm researching this suspicious wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — pull me all the token volume data you can from Arkham so I can see its transfer history in USD and native amounts."}],"resultDescription":"An array of hourly buckets, each containing a UTC timestamp and four volume metrics: inUSD (token inflows converted to USD), outUSD (token outflows converted to USD), inValue (native token inflow amount), and outValue (native token outflow amount). Each record represents one hour of aggregated transfer activity for the queried address.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Address with no token transfers returns an empty array","Unsupported token or address type may return no data","Requesting very long time ranges may result in timeout or truncated data","Insufficient USDC balance (x402 payment failure) returns a 402 Payment Required error","Rate limiting if too many concurrent requests are made"],"whenToPreferThis":"Use this endpoint when you need granular, time-series volume data (inflows and outflows) for a specific wallet address, denominated in both USD and native token units. Prefer Arkham's data when you need labeled, intelligence-enriched on-chain data rather than raw node queries. Best suited for whale tracking, due diligence, compliance screening, or DeFi flow analysis where hourly granularity and USD conversion are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:06.332Z","isFirstParty":false}