# Synapse API — Celo Token Balances

> Synapse API — Celo Token Balances is a paid API for AI agents from synapse-api-brown.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns token balances for a given wallet address on the Celo blockchain, optionally filtered by specific ERC-20 contract addresses.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/celo/token/balances
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synapse-api-celo-token-balances-3b780561
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_baBJbN-fajDsN8Ko5RJDR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability synapse-api-celo-token-balances-3b780561 -d '<json body>'
```

Example prompt: What ERC-20 token balances does the Celo wallet 0x4f9e3186513224d6B96D5d5F6E23Ee42C91fB7D5 hold? Check all tokens including cUSD and CELO.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "owner": {
   "type": "string"
  },
  "contractAddresses": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synapse-api-celo-token-balances-3b780561/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from synapse-api-brown.vercel.app](https://www.zero.xyz/host/synapse-api-brown.vercel.app/llms.txt)