# Phantom API — Humanity Token Balances

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

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/humanity/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-humanity-token-balances-3ff3c5ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T-8sW6RjvzrVrjhxRw6rw

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-humanity-token-balances-3ff3c5ae -d '<json body>'
```

Example prompt: What token balances does the wallet 0xABC123... hold on the Humanity Protocol network? Check against contract addresses 0xDEF456... and 0x789GHI....

## When to prefer this

Choose this endpoint when you need fast, pay-per-call token balance lookups specifically on the Humanity Protocol network without committing to a subscription-based RPC provider. Ideal for agents that need occasional on-demand balance checks rather than continuous monitoring.

## Known failure modes

- Invalid owner address format returns an error or empty result
- Unknown or unsupported contract address returns zero balance or error
- Wallet with no token holdings returns empty balances array
- Network congestion or RPC errors may cause timeouts
- Malformed request body (missing owner field) returns 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 structured response containing token balances for the specified wallet owner address, optionally scoped to the provided contract addresses on the Humanity Protocol network. Typically includes token amounts, contract addresses, and possibly token metadata per holding.

## 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-humanity-token-balances-3ff3c5ae/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)