# Synapse API — Gnosis Token Balances

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

Fetches ERC-20 token balances for a given wallet address on the Gnosis (xDai) blockchain, optionally filtered by specific contract addresses.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/gnosis/token/balances
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synapse-api-gnosis-token-balances-e0d67df2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yauq-J-EcYwDR_yH5hVaJ

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-gnosis-token-balances-e0d67df2 -d '<json body>'
```

Example prompt: What ERC-20 token balances does the wallet 0xAbC123...def456 hold on the Gnosis chain? Also check balances for contract addresses 0xToken1... and 0xToken2....

## When to prefer this

Choose this endpoint when you specifically need ERC-20 token balances on the Gnosis (xDai) blockchain. It is distinct from Ethereum mainnet or other EVM chain balance endpoints and is ideal for agents auditing DeFi positions, DAOs, or personal wallets operating within the Gnosis ecosystem.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Non-existent contract addresses may return zero balances or errors
- Rate limiting or payment failure (x402) blocks the call
- Gnosis RPC node downtime may cause timeouts
- Empty contractAddresses array may return all tokens or none depending on implementation

## 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 the Gnosis (xDai) chain, including token amounts and associated contract addresses. If specific contract addresses are provided, results are filtered to those tokens only.

## 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-gnosis-token-balances-e0d67df2/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)