# Phantom API — BNB Token Balances

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

Returns token balances for a given wallet address on the BNB Chain, optionally filtered by specific contract addresses.

## Facts

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

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

Example prompt: What BEP-20 token balances does wallet 0xAbC123...456 hold on BNB Chain? Also check its balance for the token contracts 0xToken1... and 0xToken2....

## When to prefer this

Use this endpoint when you need on-chain token balance data specifically for the BNB Smart Chain (BNB/BSC network) for a given wallet address. It is preferable when you need fast, pay-per-call access without a long-term API subscription, and supports filtering by specific BEP-20 contract addresses for precision queries.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Non-existent contract addresses may return zero balances or errors
- Rate limiting or payment failure (x402) if USDC payment is not properly attached
- BNB Chain node downtime may cause temporary unavailability
- Empty array returned if wallet holds no tokens or no matching contracts found

## 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 wallet address on BNB Chain, including token amounts and associated contract metadata. When 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-bnb-token-balances-29a4bf09/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)