# Phantom API — Gnosis Token Balances

> Phantom API — Gnosis 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-10-20).

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

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/gnosis/token/balances?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-gnosis-token-balances-3e555326
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_86JPiwC5yQYnQ6k0uxscH

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-gnosis-token-balances-3e555326 -d '<json body>'
```

Example prompt: What token balances does the wallet 0xAbC123...def456 hold on Gnosis chain? Also check the balance for the token contract 0xToken789...

## When to prefer this

Use this endpoint when you need fast, pay-per-call token balance lookups specifically on the Gnosis chain without committing to a subscription. Ideal for agents doing on-demand portfolio checks, DeFi analytics, or wallet audits on Gnosis. Prefer this over Ethereum mainnet balance endpoints when the user's assets are specifically on Gnosis (xDAI chain).

## Known failure modes

- Invalid or malformed owner wallet address returns an error or empty result
- Unrecognized or non-existent contract addresses may return zero balances or be omitted
- Network congestion or RPC issues may cause timeouts
- Payment failure via x402 protocol blocks the request
- Empty contractAddresses array may return all tokens or nothing depending on API behavior

## 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 Gnosis blockchain. Each entry typically includes the token contract address, token symbol or name, and the balance amount held by the owner. If specific contract addresses are provided, results are filtered to only those tokens.

## 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-gnosis-token-balances-3e555326/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)