# Synapse API — Linea Token Balances

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

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

## Facts

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

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-linea-token-balances-cc848bc9 -d '<json body>'
```

Example prompt: What ERC-20 token balances does wallet 0xAbC...123 hold on the Linea network? Also check balances for contract addresses 0xToken1 and 0xToken2.

## When to prefer this

Choose this endpoint when you specifically need ERC-20 token balance data on the Linea blockchain network. It is ideal for DeFi portfolio queries, pre-transaction balance checks, and wallet auditing on Linea. Prefer this over generic multi-chain balance APIs when Linea is specifically required, and over on-chain RPC calls when you want a pay-per-call managed API without managing your own node.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Non-existent or incorrect contract address returns zero balance or error
- Linea RPC node unavailability causes timeout or 503
- Rate limit exceeded returns payment or throttle error
- No tokens held by address returns empty array

## 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 held by the specified owner address on the Linea blockchain, including token contract addresses, amounts, and potentially token metadata such as symbol and decimals. If contract addresses are provided, results are filtered to those specific 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-linea-token-balances-cc848bc9/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)