# Phantom API — Token Balances

> Phantom API — Token Balances is a paid API for AI agents from phantom-api-omega.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Fetches ERC-20 and other token balances for a given wallet address across 57+ blockchain networks

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/stable/token/balances?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-token-balances-0412c856
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DpqVjeX-k8Fq8CF5ffUXN

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 phantom-api-token-balances-0412c856 -d '<json body>'
```

Example prompt: What are the token balances for wallet 0xABC...123, specifically for USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and USDT (0xdAC17F958D2ee523a2206206994597C13D831ec7)?

## When to prefer this

Choose this endpoint when you need fast, pay-per-call on-chain token balance lookups without committing to a subscription. Ideal for agents that intermittently need wallet token data across many networks (57+) without setting up a dedicated RPC node or indexer. Best when you need specific contract-level token balances for a known wallet address.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unknown or unsupported contract address may return zero balance or an error
- Network congestion may cause delayed or incomplete data
- Unsupported blockchain network results in an error response
- Payment failure (insufficient USDC) blocks the request via x402 protocol

## How this service works

Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.

## Output

Returns a structured list of token balances for the specified wallet address, including balance amounts for each requested contract address (or all held tokens if no contracts are specified), denominated in the token's native units.

## 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/phantom-api-token-balances-0412c856/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from phantom-api-omega.vercel.app](https://www.zero.xyz/host/phantom-api-omega.vercel.app/llms.txt)