{"uid":"cap_1cFvjWYJaU39ssuFgBocL","slug":"synapse-api-worldchain-token-balances-78397f74","name":"Synapse API — Worldchain 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/worldchain/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_cuf97L5WMhdaRWaISqPOs","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 Worldchain blockchain network","exampleAgentPrompt":"What are the token balances for wallet 0xAbC123... on Worldchain for these token contracts: 0xToken1, 0xToken2, and 0xToken3?","exampleUseCases":[{"title":"Portfolio audit for a Worldchain wallet","prompt":"Can you check the balances of all these ERC-20 tokens — 0xToken1, 0xToken2, 0xToken3 — for my Worldchain wallet 0xMyWallet123 so I can see what I'm holding?"},{"title":"DeFi app balance verification","prompt":"Before I trigger the swap, can you verify what balances wallet 0xUserWallet holds for contract addresses 0xTokenA and 0xTokenB on Worldchain?"},{"title":"Multi-token treasury snapshot","prompt":"I need a snapshot of the token balances across these five contract addresses for our treasury wallet 0xTreasury456 on Worldchain — can you pull that for me?"}],"resultDescription":"Returns a list of token balances for the specified wallet address on Worldchain, keyed by ERC-20 contract address, including balance amounts (typically as raw BigInt or formatted values per token).","failureModes":["Invalid or malformed wallet address returns an error or empty result","Non-existent or invalid contract addresses may return zero balances or an error","Network unavailability or Worldchain RPC issues may cause timeouts","Payment failure via x402 results in 402 response and no data returned","Empty contractAddresses array may return no results or an error"],"whenToPreferThis":"Choose this endpoint when you need to retrieve ERC-20 token balances specifically on the Worldchain network, especially for multiple token contracts at once. It is preferable when you already have a list of contract addresses and a target wallet, and need a fast, pay-per-call lookup without setting up your own RPC node. Best suited for agents or apps integrating Worldchain portfolio data without managing blockchain infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:05:13.689Z","isFirstParty":false}