{"uid":"cap_baBJbN-fajDsN8Ko5RJDR","slug":"synapse-api-celo-token-balances-3b780561","name":"Synapse API — Celo 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/celo/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_kjzgNUMgU9rzsYUmTv2_t","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 on the Celo blockchain, optionally filtered by specific ERC-20 contract addresses.","exampleAgentPrompt":"What ERC-20 token balances does the Celo wallet 0x4f9e3186513224d6B96D5d5F6E23Ee42C91fB7D5 hold? Check all tokens including cUSD and CELO.","exampleUseCases":[{"title":"DeFi portfolio snapshot on Celo","prompt":"Can you pull all the token balances for my Celo wallet 0x4f9e3186513224d6B96D5d5F6E23Ee42C91fB7D5? I want to see everything I'm holding across cUSD, CELO, and any other ERC-20s."},{"title":"Check specific token holdings before a swap","prompt":"Before I do a swap, can you check how much cUSD (contract 0x765DE816845861e75A25fCA122bb6898B8B1282a) my Celo address 0xABC123...def holds?"},{"title":"Monitor airdrop eligibility by token balance","prompt":"I need to verify whether the Celo address 0x9a71012B13CA4d3D0Cdc72A177df3ef03b0E76d2 holds any tokens from these three contract addresses — can you look up all their balances on Celo?"}],"resultDescription":"Returns a list of token balances associated with the specified owner wallet on the Celo network, including token contract address, symbol, decimals, and balance amount for each token held (optionally filtered to the requested contract addresses).","failureModes":["Invalid owner address format returns a 400 or validation error","Invalid contract address in the array returns an error or is silently skipped","Address with no token balances returns an empty array","Celo RPC node unavailable causes a 500 or timeout","Malformed request body missing 'owner' field returns a schema validation error","Rate limiting or payment failure via x402 results in a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need token balance data specifically on the Celo blockchain. It supports multi-token balance queries in a single call and accepts optional contract address filtering. Prefer this over generic Ethereum balance endpoints when your use case involves Celo-native tokens like cUSD, cEUR, or CELO. It is pay-per-call at $0.01 USDC via x402, making it cost-effective for on-demand lookups rather than high-frequency polling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:56:31.829Z","isFirstParty":false}