# Phantom API — Celo Token Balances

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

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

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/celo/token/balances
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-celo-token-balances-29b41a44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EPDwQDAsZLjXBHe2-Om_n

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-celo-token-balances-29b41a44 -d '<json body>'
```

Example prompt: What token balances does wallet 0x4f4495243837681061C4743b74B3eEdf548D56A5 hold on the Celo network? Also check the cUSD contract at 0x765DE816845861e75A25fCA122bb6898B8B1282a.

## When to prefer this

Choose this endpoint when you specifically need token balance data on the Celo network and want fast, pay-per-call access without a subscription or API key overhead. Ideal for agents querying Celo DeFi portfolios, verifying on-chain holdings, or enriching wallet data with current balances across ERC-20 and native tokens on Celo.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Non-existent contract address returns zero balance or error
- Network congestion may cause slower-than-usual response
- Unsupported token standards may not appear in results
- Missing required 'owner' field returns a 400-level error

## 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 balance records for the specified Celo wallet address, including token amounts and metadata (such as symbol, decimals, and contract address) for each held token, filtered to any specified contract addresses if provided.

## 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-celo-token-balances-29b41a44/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)