{"uid":"cap_msBb1VjYQCvH9LRX9BEkM","slug":"synapse-api-base-token-balances-lookup-8b9dd5b6","name":"Synapse API — Base 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/base/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_gdmCfoL4E9HNi6JTyWXBL","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 ERC-20 token balances for a given wallet address on the Base blockchain, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What ERC-20 token balances does wallet 0xAbc123...def456 hold on the Base blockchain? Check for USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and any other tokens.","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you look up all the ERC-20 token balances for my wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Base? I want to see everything I'm holding."},{"title":"Verify specific token receipt","prompt":"I'm expecting a USDC payment on Base — can you check if wallet 0xAbCd1234...5678 has a USDC balance at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?"},{"title":"Multi-contract token audit","prompt":"Please fetch token balances for 0x1234567890abcdef1234567890abcdef12345678 on Base, checking these three contract addresses: 0xAaa..., 0xBbb..., and 0xCcc... — I need to audit what they hold."}],"resultDescription":"Returns a list of token balances associated with the specified owner wallet on the Base network, including balance amounts per token contract. When contract addresses are provided, results are scoped to those specific ERC-20 tokens only.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Unknown or non-existent contract address returns zero balance or error","Rate limiting or payment failure (x402) blocks the call","Network unavailability of Base RPC returns a timeout or service error","Empty contractAddresses array may return all tokens or require at least one entry depending on implementation"],"whenToPreferThis":"Choose this endpoint when you need to check ERC-20 token balances specifically on the Base blockchain for a known wallet address. It is particularly useful when you want to filter balances by specific contract addresses rather than scanning all assets. Prefer this over general-purpose blockchain explorers when you need a programmatic, pay-per-call result with fast latency via the x402 micropayment protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:02:15.066Z","isFirstParty":false}