{"uid":"cap_UwJjNgfuOZW1NImTEsRzN","slug":"blockpin-erc-20-token-flow-check-d8b74528","name":"Blockpin ERC-20 Token Flow Check","description":"Token flow check: every ERC-20 Transfer of one token into and out of an address (a vault, treasury, fee receiver or wallet) since block N, with totals, net, top counterparties, the largest transfers and the balance now. Use it to check claims like 'x% of every trade lands in the vault'. Ethereum, Base and Robinhood Chain. Independent, by Blockpin; not a Claus Network service.","url":"https://check.blockpin.dev/flows?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain","token","address","since"],"properties":{"chain":{"enum":["ethereum","base","robinhood"],"type":"string"},"since":{"type":"string","pattern":"^[0-9]+$","description":"Start block (Ethereum: up to 1,000,000 back; Robinhood Chain: up to 7,000,000)"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token address"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address whose flows to sum (vault, treasury, fee receiver, wallet)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["summary","incoming","outgoing"],"properties":{"net":{"type":"string"},"summary":{"type":"string"},"incoming":{"type":"object"},"outgoing":{"type":"object"},"balanceAtToBlock":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Lnqe-HMj3Dm8qRj8kSGBl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all ERC-20 transfers of a specific token into and out of a given address since a start block, with totals, net flow, top counterparties, largest transfers, and current balance.","exampleAgentPrompt":"Can you check all USDC flows into the vault address 0xAbC...123 on Base since block 10000000 — I want to know the total in, total out, net, and who the biggest senders are?","exampleUseCases":[{"title":"Verify DeFi fee-sharing claim","prompt":"This protocol claims 1% of every swap goes to the fee receiver at 0xFee...abc on Ethereum. Can you pull all WETH flows into that address since block 18000000 and tell me the totals and net to see if that adds up?"},{"title":"DAO treasury inflow audit","prompt":"I need to audit our DAO treasury on Base — the address is 0xDAO...xyz and the token is 0xToken...456. Pull all token flows since block 5000000 so I can see total inflows, outflows, net balance, and our top counterparties."},{"title":"Investigate suspicious wallet draining","prompt":"Someone is claiming the team wallet at 0xTeam...789 on Robinhood Chain hasn't sent out any tokens since launch at block 1000. Can you check all flows of token 0xTkn...321 out of that address since block 1000 and show me the outgoing total and largest transfers?"}],"resultDescription":"Returns a structured JSON object with a human-readable summary, incoming transfer totals (count and amount), outgoing transfer totals (count and amount), net flow, top counterparties by volume, the largest individual transfers, and the current token balance of the address at the latest block checked.","failureModes":["Invalid token or address format (must be 0x-prefixed 40-hex-character addresses)","Start block is too far back (Ethereum: max 1,000,000 blocks; Robinhood Chain: max 7,000,000 blocks)","Unsupported chain value (must be 'ethereum', 'base', or 'robinhood')","No transfers found for the given token/address/block range (empty result)","Payment not confirmed (x402 payment required at $0.01 USDC per call)","RPC timeout for high-volume addresses with many transfers"],"whenToPreferThis":"Choose this endpoint when you need to audit or verify ERC-20 token flows through a specific address on Ethereum, Base, or Robinhood Chain — especially to fact-check protocol claims like 'X% of fees go to the vault', investigate treasury movements, or understand the net position and counterparty relationships of any wallet. Prefer this over a generic block explorer when you need aggregated totals, net flow, top counterparties, and largest transfers in a single structured response rather than raw transaction lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:30.106Z","isFirstParty":false,"canonicalSlug":"blockpin-erc-20-token-flow-check-d8b74528"}