{"uid":"cap_dv6JvaC1HXI1Q3-f7hz9e","slug":"brainiac-wallet-intelligence-transfer-history-88295e78","name":"BRAINIAC Wallet Intelligence — Transfer History","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/wallet-intelligence/transfers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":100,"maximum":1000,"minimum":1},"toBlock":{"type":"integer","maximum":9007199254740991,"minimum":0},"fromBlock":{"type":"integer","maximum":9007199254740991,"minimum":0},"walletAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"tokenAddresses":{"type":"array","items":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"maxItems":20}}},"responseSchema":{"type":"json","example":{"sources":[{"url":"https://mainnet.base.org","source":"Base JSON-RPC","retrievedAt":"2026-10-29T12:00:00.000Z"}],"toBlock":18001000,"incoming":{"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913":"100000000"},"netFlows":[{"net":"100000000","incoming":"100000000","outgoing":"0","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"outgoing":{},"fromBlock":18000000,"transfers":[{"to":"0x1234567890123456789012345678901234567890","from":"0xabcdef1234567890abcdef1234567890abcdef12","value":"100000000","txHash":"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef","direction":"incoming","timestamp":"2026-10-29T12:00:00.000Z","blockNumber":18000500,"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"limitations":["Block range is limited to 10000 blocks.","Transfers are limited to explicitly supplied token addresses.","Does not claim complete wallet transaction history."],"retrievedAt":"2026-10-29T12:00:00.000Z","currentBlock":18001000,"transferCount":1,"walletAddress":"0x1234567890123456789012345678901234567890","scannedBlockRange":"18000000-18001000","uniqueCounterparties":["0xabcdef1234567890abcdef1234567890abcdef12"],"uniqueTokenContracts":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kykf74JZncTdYGjnY41l_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and aggregates ERC-20 token transfer history for a given wallet address on Base, including incoming/outgoing flows and net balances by token.","exampleAgentPrompt":"Pull the token transfer history for wallet 0x1234567890123456789012345678901234567890 on Base, looking at USDC (0x833589fcd6edb6e08f4c7c32d4f71b54ba029339b) transfers between blocks 18000000 and 18001000, and show me the incoming, outgoing, and net flows.","exampleUseCases":[{"title":"Audit USDC inflows for a treasury wallet","prompt":"Check the USDC transfer history for our treasury wallet 0xAbCdEf1234567890AbCdEf1234567890AbCdEf12 on Base between blocks 17900000 and 18000000 — I want to see who sent us funds and the total net flow."},{"title":"Track counterparties sending tokens to an address","prompt":"For wallet 0x9999888877776666555544443333222211110000, scan blocks 18000000 to 18010000 and list every unique address that sent us tokens, broken down by token contract."},{"title":"Verify token receipt after a DeFi transaction","prompt":"I just did a swap and want to confirm the tokens arrived — can you check wallet 0xDeAdBeEf0000000000000000000000000000CaFe for any incoming transfers of token 0x833589fcd6edb6e08f4c7c32d4f71b54ba029339b in the last 500 blocks around block 18001000?"}],"resultDescription":"Returns a JSON object containing individual transfer records (with to/from addresses, value, txHash, timestamp, block number, direction), aggregated incoming and outgoing totals by token address, net flow per token, unique counterparties, unique token contracts seen, the scanned block range, and metadata about data sources and limitations.","failureModes":["Block range exceeds 10,000 blocks — response will note the limitation and may return partial data","Token addresses not supplied — only explicitly provided token contracts are scanned, so unknown tokens will be missed","Invalid wallet address format (not a 0x hex address) — schema validation error","Invalid or non-existent block numbers — may return empty transfer list","Limit too low — results may be truncated if transfer count exceeds limit parameter","Network unavailability of Base JSON-RPC — retrieval error in sources array"],"whenToPreferThis":"Choose this endpoint when you need on-chain token transfer history specifically on the Base network and want structured net-flow aggregations (incoming, outgoing, net by token) alongside raw transfer records. It is ideal for wallet auditing, DeFi accounting, and counterparty analysis when you already know the token contract addresses of interest. Prefer alternatives if you need full transaction history across all tokens without pre-specifying contracts, need data from chains other than Base, or require more than 10,000 blocks of history in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-15T06:38:10.847Z","isFirstParty":false,"canonicalSlug":"brainiac-wallet-intelligence-transfer-history-88295e78"}