# Phantom API — Ronin Token Balances

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

Retrieves token balances for a given wallet address on the Ronin blockchain, optionally filtered by specific contract addresses.

## Facts

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

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-ronin-token-balances-e9a9f553 -d '<json body>'
```

Example prompt: What tokens does the Ronin wallet 0xABC123...DEF hold right now? Check for balances across these contracts: 0xToken1 and 0xToken2.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call token balance lookups on the Ronin blockchain specifically — particularly for Axie Infinity, Sky Mavis, or other Ronin-native ecosystem tokens. It is ideal for agents that only need occasional on-chain reads without committing to a subscription-based RPC provider. Prefer it over general-purpose EVM balance APIs when Ronin-specific network support is required.

## Known failure modes

- Invalid or malformed owner address returns an error or empty result
- Unknown contract addresses return zero balances or empty arrays
- Network unavailability or Ronin RPC downtime causes timeout or 5xx error
- Payment failure via x402 protocol results in 402 Payment Required with no data returned
- Rate limiting if too many requests are made in a short window

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

## 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-ronin-token-balances-e9a9f553/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)