{"uid":"cap_UUtSbVXPAS3SEPfWFPoL9","slug":"synapse-api-token-balances-lookup-645eae9a","name":"Synapse API — Token Balances Lookup","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/bob/token/balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string"},"contractAddresses":{"type":"array","items":{"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_96fTlm5sfRwdhmYWtM46x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches token balances for a given wallet address across specified ERC-20 contract addresses on supported blockchain networks","exampleAgentPrompt":"What are the token balances for wallet 0xABC...123 for the contracts 0xToken1 and 0xToken2?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Can you pull the token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across these contracts: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and 0xdAC17F958D2ee523a2206206994597C13D831ec7?"},{"title":"Verify whale wallet token holdings","prompt":"I want to check how much USDC and USDT a known whale wallet holds — the address is 0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503, using their respective contract addresses."},{"title":"Monitor user balances before a transaction","prompt":"Before we proceed, look up the current token balances for 0x742d35Cc6634C0532925a3b8D4C9E5 for the governance token at contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984."}],"resultDescription":"Returns the token balances held by the specified wallet owner address for each of the provided ERC-20 contract addresses, likely including token amounts and possibly token metadata per contract.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Invalid contract addresses return zero balances or errors","Network congestion or RPC node issues may delay or fail responses","Unsupported blockchain network for the given contract may return null","Missing required 'owner' field causes a 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to programmatically check on-chain ERC-20 token balances for a specific wallet address across one or more contract addresses, especially when integrating into a pay-per-call agent workflow via x402. Prefer this over general blockchain explorers when you need machine-readable balance data without manual lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:57:52.449Z","isFirstParty":false}