# Phantom API — BOB Token Balances

> Phantom API — BOB 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 owner address on the BOB (Build on Bitcoin) network, optionally filtered by contract addresses

## Facts

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

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-bob-token-balances-ee928757 -d '<json body>'
```

Example prompt: What token balances does the wallet 0xAbc123...def456 hold on BOB? Check for these contracts: 0xToken1... and 0xToken2....

## When to prefer this

Choose this endpoint when you need fast, pay-per-call token balance lookups specifically on the BOB (Build on Bitcoin) network. Prefer it over general-purpose RPC calls when you want a simple HTTP API without managing node connections, and when per-query micropayment billing via x402/USDC is acceptable. Best suited for spot checks and agent-driven queries rather than high-volume batch processing.

## Known failure modes

- Invalid or malformed owner address returns an error or empty result
- Unknown or undeployed contract address returns zero balance or an error
- Network congestion may cause slower-than-expected response
- Payment not processed (x402 protocol failure) results in 402 response
- Rate limiting or infrastructure downtime on the Vercel deployment

## 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 held by the specified owner address on the BOB network, including token amounts and potentially token metadata such as symbol and decimals, optionally filtered to only the provided 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-bob-token-balances-ee928757/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)