# CortexCloud Token Balance Lookup

> CortexCloud Token Balance Lookup is a paid API for AI agents from api.cortexcloud.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the token balance for a given wallet address on the Base blockchain network

## Facts

- Endpoint: GET https://api.cortexcloud.org/x402/v1/data/base/token-balance
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cortexcloud-token-balance-lookup-83020748
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wUp1VACy9j76eBzmthBIJ

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 cortexcloud-token-balance-lookup-83020748
```

Example prompt: What's the token balance for wallet 0xAbc123...def on Base — specifically for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call on-chain token balance lookup on Base without managing your own RPC node, API keys, or subscriptions. Ideal for AI agents that need ad-hoc balance checks as part of a larger workflow without infrastructure overhead.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported or non-existent token contract address returns zero or error
- Network congestion or RPC issues may cause timeout
- Rate limiting if too many calls are made in rapid succession
- Missing required parameters (address or token contract) returns a 400-level error

## How this service works

OpenAI-compatible AI and data API for agents. Pay per call in USDC on Base via x402 — no API keys, no subscriptions, no lock-in.

## Output

Returns the on-chain token balance for the specified wallet address and token contract on the Base network, typically as a numeric value representing the raw or formatted token amount held by that address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "format": "application/json",
 "example": {
  "raw": "0",
  "token": "0x...",
  "address": "0x...",
  "network": "base"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cortexcloud-token-balance-lookup-83020748/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cortexcloud.org](https://www.zero.xyz/host/api.cortexcloud.org/llms.txt)