# CoinStats Wallet Balance

> CoinStats Wallet Balance is a paid API for AI agents from x402.coinstats.app, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-13).

Returns live coin and token balances with USD values for a wallet address on a specified blockchain

## Facts

- Endpoint: GET https://x402.coinstats.app/wallet/balance?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-coinstats-app-4122ab9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nFT0QE3m6pEK15k7jiHZd

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 x402-coinstats-app-4122ab9c
```

Example prompt: What's the current balance of wallet 0x742d35Cc6634C0532925a3b8D4C9C6b on Ethereum — show me each token and its USD value.

## When to prefer this

Use this endpoint when you need a real-time snapshot of what a single wallet holds on one specific blockchain, including USD valuations. Prefer this over transaction history endpoints when you want current state rather than historical activity, and over multi-chain portfolio endpoints when you know the specific chain.

## Known failure modes

- Invalid wallet address format returns error or empty result
- Unsupported blockchain returns error — use /wallet/connections to get valid connectionIds
- Wallet with no activity returns empty balances array
- Rate limiting or payment failure (402) if USDC payment not attached
- Network timeout if blockchain RPC is slow to respond

## How this service works

CoinStats live balance for a wallet address on a single blockchain — coins and token amounts with USD values

## Output

A list of coins and tokens held by the wallet on the specified blockchain, with exact amounts and current USD values for each holding, plus a total portfolio value in USD.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-coinstats-app-4122ab9c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.coinstats.app](https://www.zero.xyz/host/x402.coinstats.app/llms.txt)