# Phantom API — Soneium Token Balances

> Phantom API — Soneium 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 native token balances for a wallet address on the Soneium network, optionally filtered by specific contract addresses

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/soneium/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-soneium-token-balances-f1cffbd2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gcl3-aRp5ezKCxEoaHNj9

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-soneium-token-balances-f1cffbd2 -d '<json body>'
```

Example prompt: Check all token balances for the Soneium wallet 0xAbc123...def456, and also specifically tell me how much of the tokens at contracts 0xToken1... and 0xToken2... it holds.

## When to prefer this

Use this endpoint when you need fast, pay-per-call token balance lookups specifically on the Soneium network without committing to a subscription. It is ideal for agents that need on-demand portfolio or balance checks across multiple token contracts for any wallet, especially in a multi-chain setup where Soneium coverage is explicitly needed.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Contract addresses that don't exist on Soneium return zero balances or errors
- Network congestion or RPC issues may cause timeouts
- Payment failure via x402 prevents the call from completing
- Newly deployed contracts may not yet be indexed

## 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 associated with the specified wallet owner on the Soneium network. Each entry typically includes the token contract address, token symbol or name, and the balance amount held by the wallet. If specific contract addresses are provided, results are filtered to those tokens only.

## 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-soneium-token-balances-f1cffbd2/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)