# Phantom API — zkSync Token Balances

> Phantom API — zkSync 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).

Fetches ERC-20 and native token balances for a wallet address on the zkSync network, optionally filtered by specific contract addresses.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/zksync/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-zksync-token-balances-8049fcb1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MzYnwmNopxLhOgE3ntwih

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-zksync-token-balances-8049fcb1 -d '<json body>'
```

Example prompt: What ERC-20 token balances does the zkSync wallet 0xAbC123...def hold? Also check the balances for contract addresses 0xToken1... and 0xToken2....

## When to prefer this

Choose this endpoint when you need fast, pay-per-call token balance lookups on the zkSync (Era) L2 network without setting up your own RPC infrastructure. It is ideal for lightweight agents that need on-demand portfolio or balance data for zkSync wallets without committing to a subscription. Prefer this over generic Ethereum balance APIs when the target wallet specifically operates on zkSync.

## Known failure modes

- Invalid owner address format returns an error or empty result
- Non-existent or zero-balance wallet returns empty array
- Invalid contract address in the filter list may be ignored or cause partial failure
- Rate limiting or payment failure (x402) results in a 402 response requiring USDC payment
- zkSync network downtime or RPC errors may cause timeouts or 503 responses

## 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 held by the specified wallet address on the zkSync network. Each entry typically includes the token contract address, token symbol, decimals, and balance amount. If contract addresses are provided, the response is 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-zksync-token-balances-8049fcb1/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)