{"uid":"cap_lfmWBqA_Hrnp0QlaYQ2cZ","slug":"synapse-api-abstract-token-balances-975703a2","name":"Synapse API — Abstract 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/abstract/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_iMkZA_7hxLylcI7AMc-j-","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 address across specified ERC-20 or native token contract addresses on Abstract (or supported blockchain networks)","exampleAgentPrompt":"Can you check the token balances for wallet address 0xAbC123...def and these two contract addresses: 0xToken1... and 0xToken2...?","exampleUseCases":[{"title":"DeFi portfolio snapshot for wallet","prompt":"Pull the token balances for wallet 0xAbC123...def across these contract addresses: 0xUSDC..., 0xWETH..., and 0xDAI... — I want to see exactly how much of each token they're holding."},{"title":"Verify token eligibility for airdrop","prompt":"Check whether wallet 0xDeFi456...abc holds any balance of the token at contract 0xNewToken... — I need to confirm eligibility before the airdrop snapshot."},{"title":"Monitor whale wallet holdings","prompt":"Look up the current token balances for 0xWhale789...xyz for contracts 0xPEPE... and 0xSHIB... so I can track what that wallet is accumulating."}],"resultDescription":"Returns a structured list of token balances for the specified wallet owner address, keyed by each provided contract address, including balance amounts and potentially token metadata such as symbol and decimals.","failureModes":["Invalid or malformed owner address returns an error or empty result","Unsupported contract address returns null or zero balance","Rate limiting or payment failure (x402) returns a 402 Payment Required response","Network timeout if the underlying blockchain node is slow","Empty contractAddresses array may return no results or an error"],"whenToPreferThis":"Choose this endpoint when you need to look up on-chain token balances for a specific wallet across one or more ERC-20 or native token contracts, especially when operating in an agent pipeline that supports x402 pay-per-call micropayments. Prefer this over general blockchain explorers when you need programmatic, API-level access to balance data without scraping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:11:49.545Z","isFirstParty":false}