{"uid":"cap_v76t-p9Fb--kzOdLlevwt","slug":"agent-data-tools-revmesh2074-workers-dev-token-transfers-berachain-592fc74e","name":"Token Transfers, Berachain","description":"List a wallet's recent transfers of one ERC-20 token (default USDC) on Berachain, in and out, over the last N blocks (1-2,000, default 1,000): direction, counterparty, amount and transaction, newest first, up to 50. Use to confirm a payment arrived or see what was sent; for the current balance use bera_token_balance. Malformed addresses are rejected with 400, uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/bera/token-transfers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"token":{"type":"string","description":"Token: a ticker such as USDT or WETH, or the 0x ERC-20 contract (default: USDC on this network)"},"blocks":{"type":"integer","description":"How many recent blocks to scan (1-2000, default 1000; 2,000 blocks is about 67 minutes on Berachain)"},"address":{"type":"string","description":"0x wallet address"}}},"responseSchema":{"type":"object","properties":{"chain":{"type":"string"},"count":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"transfers":{"type":"array","items":{"type":"object","properties":{"tx":{"type":"string"},"raw":{"type":"string"},"block":{"type":"number"},"token":{"type":"string"},"amount":{"type":"string"},"symbol":{"type":"string"},"direction":{"type":"string"},"counterparty":{"type":"string"}}}},"truncated":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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_Cz0v_115iKXT4bJdao3z-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Lists a wallet's recent ERC-20 token transfers (inbound and outbound) on the Berachain network over a configurable block range, newest first.","exampleAgentPrompt":"Can you show me the recent USDC transfers in and out of my Berachain wallet 0xAbC...1234 over the last 500 blocks so I can confirm a payment arrived?","exampleUseCases":[{"title":"Confirm incoming payment on Berachain","prompt":"I'm expecting a USDC payment to my Berachain address 0x1234...abcd — can you pull the last 1,000 blocks of USDC transfers and confirm it came in and who sent it?"},{"title":"Audit outgoing WETH transfers","prompt":"Show me all the WETH I've sent out from my Berachain wallet 0xDEAD...BEEF in the past 2,000 blocks so I can reconcile my transactions."},{"title":"Track token movement for a counterparty","prompt":"I need to see every USDT transfer involving address 0xFEED...CAFE on Berachain over the last 500 blocks — both what went in and what went out."}],"resultDescription":"Returns a JSON object containing the wallet address, chain name and chain ID, the scanned block range (fromBlock and toBlock), a count of transfers found, a truncated flag (true if more than 50 results exist), and an array of transfer objects each with: transaction hash, block number, token contract address, token symbol, transfer amount (as a string), direction ('in' or 'out'), and counterparty address. Results are ordered newest first, capped at 50.","failureModes":["Malformed or invalid wallet address returns HTTP 400 (no charge applied)","Token ticker not recognized may return empty results or an error","Block range outside 1–2000 may be rejected or clamped","Network congestion or RPC unavailability may return a 5xx error","Requesting more than 50 transfers truncates silently with truncated: true"],"whenToPreferThis":"Use this endpoint when you need to audit recent ERC-20 token transfers for a specific wallet on the Berachain network, particularly to confirm payment receipt or review sent transactions. Prefer this over bera_token_balance when you need transfer history, directionality, or counterparty information rather than a current balance snapshot. Choose this over a general blockchain explorer when you need structured, agent-readable JSON output with direction and counterparty fields already parsed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T00:43:20.785Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-token-transfers-berachain-592fc74e"}