# Synapse API — Berachain Token Balances

> Synapse API — Berachain 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).

Fetches ERC-20 token balances for a given wallet address on the Berachain network, optionally filtered by specific contract addresses

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/berachain/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-berachain-token-balances-ffc4ebd8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qg71EnhE6ThMqyoh9wkqN

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-berachain-token-balances-ffc4ebd8 -d '<json body>'
```

Example prompt: What ERC-20 token balances does wallet 0x1234...abcd hold on Berachain? Also check balances for these specific contracts: 0xABC...111 and 0xDEF...222.

## When to prefer this

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.

## Known failure modes

- 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

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

## 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-berachain-token-balances-ffc4ebd8/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)