{"uid":"cap_OX8rBpngcqPto-IcA_sMY","slug":"agent402-tools-wallet-asset-transfer-history-08f1f48b","name":"agent402.tools Wallet Asset Transfer History","description":"Return the most recent asset transfers (incoming + outgoing) for a wallet address - native coin, ERC-20, ERC-721, ERC-1155 - already merged and sorted newest first. Each row carries the block, tx hash, counterparty, asset, and decimal value. Cap is 100 per direction; widen the window via `fromBlock` if you need deeper history.","url":"https://agent402.tools/api/wallet-transactions","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max transfers per direction (1-100, default 25)."},"address":{"type":"string","description":"0x-prefixed 40-char hex wallet address."},"network":{"type":"string","description":"ethereum / base / polygon / arbitrum / optimism (default base)."},"fromBlock":{"type":"string","description":"Optional starting block in hex (default 0x0 = earliest)."}}},"responseSchema":{"type":"json","example":{"limit":10,"address":"0xabf4fabd7c416fb67202e5f9002389fc75e2a9d0","network":"base","transfers":[{"to":"0xabf…","from":"0x…","hash":"0xabc…","asset":"USDC","value":"0.001","blockNum":18250000,"category":"erc20","direction":"in"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cFfCzzDtsp2y-dN8cXSEp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the most recent asset transfers (native coin, ERC-20, ERC-721, ERC-1155) for a wallet address, merged and sorted newest-first with block, tx hash, counterparty, asset, and decimal value.","exampleAgentPrompt":"Can you pull the last 50 asset transfers — both incoming and outgoing — for wallet 0xAbCd...1234 on Ethereum, including native ETH, ERC-20s, and any NFTs?","exampleUseCases":null,"resultDescription":"A merged, newest-first list of up to N transfer records per direction, each containing the block number, transaction hash, counterparty address, asset name/contract, token type (native/ERC-20/ERC-721/ERC-1155), and decimal-formatted value.","failureModes":["Invalid wallet address format (not 0x-prefixed 40-char hex) returns validation error","Unsupported network name returns error — must be one of ethereum/base/polygon/arbitrum/optimism","fromBlock in wrong format (non-hex) causes parse failure","limit out of range (0 or >100) may return error or be clamped","Payment of 0.002 USDC not sent or rejected causes 402 response","Empty result set for wallets with no transfers on the specified network"],"whenToPreferThis":"Use this endpoint when you need a unified, multi-asset transfer history (native + ERC-20 + ERC-721 + ERC-1155) for a single wallet across major EVM chains, already sorted and merged — ideal for wallet auditing, portfolio tracking, or on-chain activity analysis without needing to query separate token-type endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:03:19.377Z","isFirstParty":false}