# Phantom API — Metis Token Balances

> Phantom API — Metis 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 Metis network, optionally filtered by contract addresses

## Facts

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

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-metis-token-balances-07213447 -d '<json body>'
```

Example prompt: What tokens does the wallet 0xAbC123...def456 hold on the Metis network? Also check the balance for contract 0xToken1...abc and 0xToken2...xyz.

## When to prefer this

Choose this endpoint when you specifically need token balance data on the Metis Layer 2 network. It is ideal for DeFi portfolio aggregation, airdrop eligibility checks, on-chain balance verification, or any workflow requiring fast, pay-per-call access to Metis token holdings without spinning up your own node infrastructure.

## Known failure modes

- Invalid owner address format returns a 400 error
- Non-existent or zero-balance wallet returns empty balance array
- Invalid contract address in the array causes partial or full error response
- Metis network node unavailability causes a 503 or timeout
- Payment not included or insufficient USDC causes a 402 payment required error
- Rate limiting or quota exceeded returns a 429 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 balances for the specified wallet owner on the Metis network, including token contract addresses, token symbols, decimals, and raw or formatted balance amounts for each held token (optionally scoped to specified 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-metis-token-balances-07213447/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)