{"uid":"cap_dkYhvyPrG-gs4vgU2UqOs","slug":"synapse-api-soneium-token-balances-1d380018","name":"Synapse API — Soneium 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/soneium/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_Wdlga1qh6woNPKXQW1q4p","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 owner on the Soneium blockchain, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What are all the token balances for the Soneium wallet 0xAbC123...? Also check specifically for the tokens at contract addresses 0xToken1... and 0xToken2....","exampleUseCases":[{"title":"Portfolio snapshot for Soneium wallet","prompt":"Can you pull up all the token balances held by the Soneium wallet 0x1234...abcd? I want to see everything it's holding."},{"title":"Check specific token holdings","prompt":"Does the Soneium wallet 0xDeFi...5678 have any balance of the tokens at contract addresses 0xUSDC... and 0xWETH...? If so, how much?"},{"title":"DeFi risk audit for on-chain address","prompt":"I need to audit the token exposure for Soneium address 0xAudit...9999 — can you fetch all its token balances so I can review what assets it holds?"}],"resultDescription":"Returns a list of token balances for the specified wallet on the Soneium network. Each entry typically includes the token contract address and the corresponding balance amount. Optionally filtered to only the specified contract addresses if provided.","failureModes":["Invalid or malformed owner address returns an error or empty result","Non-existent contract addresses in the filter list may return zero balances or be omitted","Wallet with no token holdings returns an empty balances array","Network downtime or Soneium RPC issues may cause timeouts or 5xx errors","Payment failure (insufficient USDC or x402 error) prevents call from completing"],"whenToPreferThis":"Use this endpoint when you specifically need token balance data on the Soneium blockchain. It supports filtering by contract address, making it ideal for targeted token lookups rather than full portfolio scans. Prefer this over generic EVM balance endpoints when the user's wallet or protocol is on Soneium specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:12:06.551Z","isFirstParty":false}