# Phantom API — Linea Token Balances

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

Fetches ERC-20 and native token balances for a given wallet address on the Linea blockchain network

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/linea/token/balances
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-linea-token-balances-e8a2f0f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5xQAvDhg04s9Fl8MKIs0U

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-linea-token-balances-e8a2f0f7 -d '<json body>'
```

Example prompt: What ERC-20 token balances does the Linea wallet 0xAbC123...def hold? Check all tokens including contract addresses 0xTokenA and 0xTokenB.

## When to prefer this

Use this endpoint when you specifically need token balance data on the Linea network (not Ethereum mainnet, Polygon, or other chains). Prefer this over generic blockchain RPCs when you need structured token balance aggregation without writing raw contract calls. At $0.01 USDC per call, it's cost-effective for one-off wallet checks, agent-driven portfolio monitoring, or DeFi dashboard integrations on Linea.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Contract address not deployed on Linea returns zero balance or error
- Linea RPC node unavailability causes timeout or 5xx error
- Payment failure via x402 protocol blocks request
- Empty contractAddresses array may return all tokens or require at least one entry depending on implementation

## 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 associated with the specified owner wallet on the Linea network, including token contract addresses and balance amounts for each held token (native and ERC-20).

## 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-linea-token-balances-e8a2f0f7/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)