# Phantom API — Worldchain Token Balances

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

## Facts

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

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-worldchain-token-balances-d89d6f5b -d '<json body>'
```

Example prompt: What token balances does the Worldchain wallet 0x1234...abcd hold? Also check balances for these specific contracts: 0xabc... and 0xdef...

## When to prefer this

Use this endpoint when you specifically need token balance data on the Worldchain network. It is ideal for agents building portfolio dashboards, DeFi tools, airdrop checkers, or wallet analytics that target Worldchain. It supports filtering by contract address, making it efficient for targeted balance lookups rather than broad portfolio scans.

## Known failure modes

- Invalid or malformed owner wallet address returns an error
- Non-existent contract addresses may return zero balances or errors
- Worldchain network outage or node unavailability causes request failure
- Empty contractAddresses array may return all tokens or nothing depending on implementation
- Rate limiting or payment failure (x402) if USDC payment is not properly attached

## 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 owner address on the Worldchain network, including token contract addresses and corresponding balance amounts, optionally scoped to the provided list of contract addresses.

## 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-worldchain-token-balances-d89d6f5b/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)