{"uid":"cap_-2zMKbE3XhEYQqkNlX3I6","slug":"arkham-x402-transfers-histogram-c5436728","name":"Arkham x402 Transfers Histogram","description":"Get Arkham detailed transfer histogram. $0.80 per call.","url":"https://api.arkm.com/x402/transfers/histogram","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to any of a comma-separated list of addresses, entities, or deposit services. Prefix a value with '!' to exclude…"},"base":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter from or to any of a comma-separated list of entities or addresses. Prefix a value with '!' to exclude it, or 'ty…"},"flow":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Transfer direction: 'in' (incoming), 'out' (outgoing), 'self' (self-transfers), or 'all'. Default: all."},"from":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter from any of a comma-separated list of addresses, entities, or deposit services. Prefix a value with '!' to exclu…"},"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 transfers across all…"},"tokens":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter involving any of a comma separated list of token addresses or token IDs."},"usdGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter above a minimum historical USD value."},"usdLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter below a maximum historical USD value."},"timeGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter after a specific time (RFC3339, YYYY-MM-DD, or Unix timestamp)."},"timeLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter before a specific time (RFC3339, YYYY-MM-DD, or Unix timestamp)."},"timeLast":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter using a duration string."},"valueGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter above a minimum token amount (the quantity of tokens, not the USD value)."},"valueLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter below a maximum token amount (the quantity of tokens, not the USD value)."},"granularity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Histogram bucket size. Calendar units: '1m' (minute), '1h' (hour), '1d' (day), '1w' (week), '1M' (month), '1q' (quarter…"},"bucketOffset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Shift every bucket boundary by this duration, for example '-60s' or '-1m'. Buckets normally start on the granularity bo…"},"counterparties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"list of addresses or entities to treat strictly as counterparties (only base <-> counterparty transfers)."}}},"responseSchema":{"type":"json","example":[{"usd":1.23,"time":"2024-01-01T00:00:00Z","count":1}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.8","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.8/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.8","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.8","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r1zmaiB2FJJESCXJkHO7X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.8","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-bucketed histogram of on-chain transfer activity (USD volume and count) for a given wallet or entity over a specified time range.","exampleAgentPrompt":"Pull the Arkham transfer histogram for wallet 0xabc...123 over the last 90 days — I want to see how USD volume and transaction count are distributed over time.","exampleUseCases":[{"title":"Whale wallet activity spike detection","prompt":"Show me the transfer histogram for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 over the past 60 days — I want to see if there were any unusual spikes in USD volume or transaction count."},{"title":"DeFi fund cadence analysis","prompt":"Pull the Arkham transfer histogram for the Alameda Research entity over the last year so I can see how frequently they were moving funds and when the big USD flows happened."},{"title":"Portfolio on-chain activity audit","prompt":"Get me the transfer histogram for my tracked wallet over the past 30 days, bucketed by day — I want to understand how much USD volume and how many transfers happened in each period."}],"resultDescription":"Returns a JSON array of time-bucketed objects, each containing a UTC timestamp ('time'), the aggregate USD value of transfers in that bucket ('usd'), and the number of individual transfers ('count'). The array is ordered chronologically, allowing reconstruction of a volume-over-time histogram.","failureModes":["Invalid or unresolvable wallet address returns empty array or 404","Time range too broad may result in very large response payload or timeout","Malformed request body (missing required fields) returns 400 Bad Request","Insufficient USDC balance for x402 payment results in 402 Payment Required","Rate limiting or quota exceeded returns 429 Too Many Requests","Unknown entity identifier returns empty result set rather than explicit error"],"whenToPreferThis":"Use this endpoint when you need aggregated, time-series transfer data for a specific wallet or entity and want bucketed USD volume and count rather than individual transaction records. Prefer it for trend analysis, anomaly detection, and charting wallet activity cadence over time. It is ideal when you already have an address or Arkham entity ID and want to understand macro-level flow patterns rather than individual transfer details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:49:13.503Z","isFirstParty":false}