# Token Balances via Alchemy

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

Fetches ERC-20 and other token balances for a given blockchain address on a specified network using Alchemy's infrastructure

## Facts

- Endpoint: POST https://stablecrypto.dev/api/alchemy/token/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/token-balances-via-alchemy-2f2a855c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bU8rRwnIfS1z5spobxC5W

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-via-alchemy-2f2a855c -d '<json body>'
```

Example prompt: What ERC-20 tokens does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold on eth-mainnet? Just fetch all token balances for that address.

## When to prefer this

Use this endpoint when you need raw token balance data for a specific address on a specific EVM network (e.g. eth-mainnet, base-mainnet) with optional filtering by specific token contracts. Prefer this over the portfolio token balances endpoint (Tokens) when you need lower-level balance data without USD value enrichment, or when you want to check specific contract addresses only.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported or misspelled network slug causes failure
- Providing invalid token contract addresses in tokenAddresses returns empty or error results
- Pagination key mismatch or expiry causes pagination to fail
- Rate limiting or upstream Alchemy outage may cause 5xx errors
- Missing required fields (address or network) results in validation error

## How this service works

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

## Output

Returns a JSON object mapping token contract addresses to their respective balance values for the queried wallet address on the specified network. Supports pagination via pageKey and optional filtering to specific token contracts.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Owner address"
  },
  "network": {
   "type": "string",
   "description": "Alchemy network slug, e.g. eth-mainnet, base-mainnet"
  },
  "pageKey": {
   "type": "string",
   "description": "Pagination key"
  },
  "tokenAddresses": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Specific token contract addresses to check"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-balances-via-alchemy-2f2a855c/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)