{"uid":"cap_6kfGByIsfW8MENKut4T0X","slug":"synapse-api-token-balances-by-owner-6e2cc90f","name":"Synapse API — Token Balances by Owner","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/adi/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_oaddHfYK7EvF92TSdyFmN","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":"Returns token balances for a given wallet address across one or more ERC-20 contract addresses on supported blockchain networks","exampleAgentPrompt":"What are the token balances for wallet address 0xABC123... across these contracts: 0xUSDC... and 0xWETH...?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Pull the token balances for wallet 0x1234...abcd for USDC (0xA0b8...eB48) and WETH (0xC02a...6Cc2) so I can see what they're holding."},{"title":"Verify token holdings before airdrop","prompt":"Check whether wallet 0xDEAD...BEEF holds any tokens from contract 0xToken...CA11 — I need to confirm eligibility before we do the airdrop."},{"title":"Monitor whale wallet token positions","prompt":"What token balances does the wallet 0xWhale...F00D have across these five contract addresses: 0xAAA..., 0xBBB..., 0xCCC..., 0xDDD..., 0xEEE...?"}],"resultDescription":"Returns the token balances held by the specified owner wallet for each of the provided contract addresses, including amounts per token contract, enabling portfolio visibility and on-chain asset verification.","failureModes":["Invalid owner address format returns an error or empty result","Unsupported contract address or network returns zero or null balance","Rate limiting or payment failure (x402) blocks the call","Network congestion may delay RPC response","Contract addresses not on a supported chain return no data"],"whenToPreferThis":"Choose this endpoint when you need fast, pay-per-call token balance lookups for one or more ERC-20 contracts on a specific wallet address without managing your own blockchain node infrastructure. It is well-suited for AI agents needing on-demand DeFi portfolio checks, airdrop eligibility verification, or whale monitoring across multiple tokens in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:03.374Z","isFirstParty":false}