{"uid":"cap_YMvDEjJsxFnWKWIR9zLDl","slug":"synapse-api-token-balances-lookup-2a0cc9a4","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/tempo/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_AFLX9pvmhjA8OnOLLPnLx","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":"Retrieves token balances for a given wallet owner address across specified ERC-20 or multi-chain contract addresses","exampleAgentPrompt":"Can you check the token balances for wallet address 0xAbC123...def and include the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"DeFi portfolio snapshot check","prompt":"What are the current token balances for my wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e? Include USDC at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and DAI at 0x6B175474E89094C44Da98b954EedeAC495271d0F."},{"title":"Pre-transaction balance verification","prompt":"Before I send the transaction, can you verify the token balance for address 0x1234...abcd for the WETH contract at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 to make sure there are enough funds?"},{"title":"Multi-token holding audit","prompt":"I need to audit the token holdings for 0xdEAD000000000000000042069420694206942069 — check balances for these contracts: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984."}],"resultDescription":"Returns a list of token balances associated with the specified owner address and contract addresses, including balance amounts per token contract, enabling portfolio analysis and pre-transaction verification.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Unknown or unsupported contract address returns zero balance or error","Network congestion may cause delayed responses","Missing required 'owner' field causes a validation error","Unsupported blockchain network for a given contract address may yield no data"],"whenToPreferThis":"Choose this endpoint when you need to fetch on-chain token balances for a specific wallet address across one or more ERC-20 or compatible token contracts in a pay-per-call model without managing your own RPC infrastructure. Ideal for spot checks, portfolio snapshots, or pre-transaction balance validation where real-time data is needed cheaply.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:01:36.037Z","isFirstParty":false}