{"uid":"cap_Qg71EnhE6ThMqyoh9wkqN","slug":"synapse-api-berachain-token-balances-ffc4ebd8","name":"Synapse API — Berachain 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/berachain/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_D8OYWpOSoIH9_V7e-GUPj","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":"Fetches ERC-20 token balances for a given wallet address on the Berachain network, optionally filtered by specific contract addresses","exampleAgentPrompt":"What ERC-20 token balances does wallet 0x1234...abcd hold on Berachain? Also check balances for these specific contracts: 0xABC...111 and 0xDEF...222.","exampleUseCases":[{"title":"DeFi portfolio snapshot on Berachain","prompt":"Show me all the token balances held by my Berachain wallet 0xABCDEF1234567890abcdef1234567890abcdef12 — I want a full snapshot of my portfolio."},{"title":"Check specific token holdings for airdrop eligibility","prompt":"Does wallet 0x9876543210fedcba9876543210fedcba98765432 hold any of these Berachain tokens: 0xToken1...aaa, 0xToken2...bbb? I need to verify eligibility."},{"title":"Monitor whale wallet token positions","prompt":"Look up all the ERC-20 token balances for this Berachain address 0xWhale000111222333444555666777888999aabbcc — I'm tracking a whale's positions."}],"resultDescription":"Returns a list of token balances for the specified wallet owner on Berachain, including token contract addresses, token amounts, and potentially token metadata such as symbol and decimals. If contract addresses are provided, results are filtered to only those tokens.","failureModes":["Invalid or malformed wallet address returns an error","Contract addresses array contains non-checksummed or invalid addresses","Wallet has no token balances — returns empty list","Berachain node unavailability causes timeout or 503","Rate limit exceeded if called too frequently without payment","Payment not received — 402 payment required error"],"whenToPreferThis":"Use this endpoint when you specifically need token balances on the Berachain network. It is purpose-built for Berachain and supports filtering by specific ERC-20 contract addresses, making it ideal for targeted portfolio checks or eligibility verification. Prefer this over generic multi-chain balance aggregators when you need fast, cheap ($0.01/call) Berachain-native lookups without needing to authenticate or manage API keys beyond the x402 payment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:55:33.865Z","isFirstParty":false}