# Token Balances

> Token Balances is a paid API for AI agents from stablecrypto.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Fetches portfolio token balances for one or more wallet addresses on a specified blockchain network, optionally including prices and metadata

## Facts

- Endpoint: POST https://stablecrypto.dev/api/alchemy/portfolio/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/token-balances-91bc1fb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2vXniE9i7bxNpQJXz8DK9

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 token-balances-91bc1fb2 -d '<json body>'
```

Example prompt: What tokens does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold on eth-mainnet? Include current prices and token metadata.

## When to prefer this

Use this endpoint when you need EVM-compatible token portfolio data (ERC-20 balances) for one or more addresses on a specific network like Ethereum mainnet or Base, especially when Alchemy's portfolio API is the underlying data source. Prefer over generic RPC calls when you want enriched metadata and price data in a single call.

## Known failure modes

- Invalid network slug returns error or empty result
- Malformed or non-checksummed wallet address may fail
- Empty addresses array may return error
- Network congestion may cause timeout
- Unsupported network slug returns error
- Rate limiting if called in high frequency

## How this service works

Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.

## Output

Returns an object mapping wallet addresses to their token balances, with optional per-token USD prices and metadata (name, symbol, decimals, logo) as requested via withPrices and withMetadata flags.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "type": "string",
   "description": "Alchemy network slug, e.g. eth-mainnet, base-mainnet"
  },
  "addresses": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Wallet addresses"
  },
  "withPrices": {
   "type": "boolean"
  },
  "withMetadata": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-balances-91bc1fb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablecrypto.dev](https://www.zero.xyz/host/stablecrypto.dev/llms.txt)