{"uid":"cap_VOz5Lh0N-hGnl_t2ayekB","slug":"synapse-api-ethereum-token-balances-63807260","name":"Synapse API — Ethereum Token Balances","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/ethereum/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_yKnkFh4iFwobrxtiBPQ8T","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 Ethereum wallet address, optionally filtered to specific contract addresses","exampleAgentPrompt":"Check all the ERC-20 token balances held by Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, and specifically look up its USDC balance at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"What ERC-20 tokens does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently hold, and what are their balances?"},{"title":"Verify token receipt on Ethereum","prompt":"Can you confirm whether wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B has received any USDT at contract 0xdAC17F958D2ee523a2206206994597C13D831ec7?"},{"title":"Multi-token balance audit","prompt":"Pull the balances for DAI at 0x6B175474E89094C44Da98b954EedeAC495271d0F and WETH at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 for the wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e."}],"resultDescription":"Returns a list of token balances for the specified Ethereum wallet address, each entry indicating the token contract address and the corresponding balance amount held by the owner. If specific contract addresses are provided, results are filtered to those tokens only.","failureModes":["Invalid Ethereum address format returns an error","Non-existent or zero-balance tokens may return empty results","Rate limiting or payment failure via x402 protocol blocks the request","Network timeouts if Ethereum RPC is slow","Contract addresses that are not valid ERC-20 tokens may return errors or empty balances"],"whenToPreferThis":"Choose this endpoint when you need to look up ERC-20 token balances on the Ethereum mainnet for one or more wallet addresses. It is especially useful for DeFi portfolio tracking, verifying token transfers, and auditing holdings across specific contracts. It covers Ethereum specifically, so prefer it over generic multi-chain endpoints when Ethereum is the target network.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:02:44.581Z","isFirstParty":false}