# Phantom API — Unichain Token Balances

> Phantom API — Unichain 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-09-14).

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

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/unichain/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/phantom-api-unichain-token-balances-d99e79e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3nDYzi-bOKU6Yewlm9wq4

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-unichain-token-balances-d99e79e1 -d '<json body>'
```

Example prompt: What ERC-20 token balances does wallet 0xAbC...123 hold on Unichain? Check for contract addresses 0xToken1 and 0xToken2.

## When to prefer this

Use this endpoint when you specifically need ERC-20 token balance data on the Unichain network. Prefer it over generic Web3 RPC calls when you want a simple, pay-per-call REST interface without managing your own node infrastructure. It is especially suitable for agents that need quick, multi-token balance lookups on Unichain without subscribing to a full blockchain data provider.

## Known failure modes

- Invalid owner address format returns an error or empty result
- Contract address array contains invalid or non-existent addresses, returning zero balances
- Unichain network congestion or RPC unavailability causes timeout
- Wallet address has no token holdings, returning an empty array
- Payment not fulfilled via x402 protocol results in 402 Payment Required response

## 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 list of token balances for the specified wallet address on the Unichain network, each entry including the token contract address and the corresponding balance amount. If contract addresses are provided, results are filtered to only those 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/phantom-api-unichain-token-balances-d99e79e1/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)