# Phantom API — Berachain Token Balances

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

## Facts

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

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-berachain-token-balances-49d434dc -d '<json body>'
```

Example prompt: What ERC-20 token balances does the Berachain wallet 0x1234...abcd currently hold — show me everything, or just check the balances for contract 0xTokenA and 0xTokenB if you want to narrow it down.

## When to prefer this

Choose this endpoint when you specifically need token balance data on the Berachain network and want a fast, pay-per-call API without a subscription. Ideal for agents performing one-off wallet lookups, DeFi portfolio checks, or due diligence on Berachain addresses without the overhead of running your own node or managing an RPC subscription.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Contract address array contains invalid addresses, causing partial or failed lookups
- Berachain node or RPC unavailability results in a timeout or 503 error
- Wallet with no token holdings returns an empty balances array
- Rate limiting or payment failure (x402) if the $0.01 USDC fee is not properly handled

## 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 wallet on the Berachain network, including token contract addresses, amounts, and potentially token metadata such as symbol and decimals. If specific contract addresses are provided, only balances for those tokens are returned.

## 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-berachain-token-balances-49d434dc/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)