{"uid":"cap_iyNbLuBR-N4myCl0eM1rq","slug":"arkham-transfers-histogram-simple-bc4e3068","name":"Arkham Transfers Histogram Simple","description":"Programmatic access to Arkham wallet intelligence and market data — via API keys and x402 pay-per-request.","url":"https://api.arkm.com/x402/transfers/histogram-simple","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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. You can also use special syntax li…"},"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."},"flow":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Transfer direction."},"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. You can also use special syntax…"},"chains":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of chains to filter by."},"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 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 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."},"timeLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter before a specific time."},"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 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 value."},"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)."}},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}]}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}}}}},"responseSchema":{"type":"json","example":[{"usd":1.23,"time":"2024-01-01T00:00:00Z","count":1}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_UdxY2ZVAIuIRcZTQkeLVG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-bucketed histogram of on-chain transfers aggregated by USD value and count over a time range","exampleAgentPrompt":"Pull the transfer volume histogram for Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 over the past 30 days so I can see how the USD value and count of transfers changed week by week.","exampleUseCases":[{"title":"Whale wallet activity monitoring","prompt":"Show me the transfer histogram for the Arkham entity 'Jump Trading' over the last 90 days — I want to see how their on-chain transfer volume in USD changed over time."},{"title":"Suspicious address activity review","prompt":"I need a time-bucketed breakdown of transfers from wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B over the past 7 days — give me the USD totals and count per bucket so I can spot any unusual spikes."},{"title":"Token flow analysis for DeFi protocol","prompt":"Get me a simple histogram of transfer activity for the Uniswap v3 deployer address over the last 6 months, showing how many transfers happened and their USD value aggregated by week."}],"resultDescription":"Returns an array of time-bucketed histogram entries, each containing a timestamp (ISO 8601), total USD value of transfers in that bucket, and a count of individual transfers. Useful for charting on-chain activity trends over time.","failureModes":["Invalid or unrecognized wallet address returns empty array or 404","Insufficient x402 payment results in 402 Payment Required with payment details","Time range too large may result in timeout or rate limiting","Unsupported chain or token filter returns empty results","Malformed POST body returns 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need a lightweight, pre-aggregated view of transfer activity over time — specifically when you want histogram buckets of USD volume and count rather than raw individual transfers. Prefer this over full transfer list endpoints when you need trend analysis, charting, or anomaly detection across a time series without processing thousands of individual records.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:48:32.681Z","isFirstParty":false}