# Cosmos Wallet Balance Lookup

> Cosmos Wallet Balance Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns native and IBC token balances for any Cosmos wallet address, with chain detection from the bech32 prefix and pagination metadata.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/cosmos-wallet-balance
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/proxy-suverse-io-2f6af549
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AS_uKNe5vEneAdWawuoH3

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 proxy-suverse-io-2f6af549 -d '<json body>'
```

Example prompt: What are all the token balances — native and IBC — for the Cosmos wallet cosmos1abcdef1234567890xyz? I need the raw IBC denom hashes too so I can trace the bridge origins.

## When to prefer this

Use this endpoint when you need comprehensive native and IBC token balances for any Cosmos ecosystem wallet, especially when chain detection from the bech32 prefix is needed without specifying the chain manually. Ideal for AI portfolio managers, IBC bridge trackers, and cross-chain analytics tools that need raw IBC denom hashes for further resolution.

## Known failure modes

- Invalid or malformed bech32 address returns an error
- Unknown or unsupported Cosmos chain prefix may fail chain detection
- Empty wallet with no balances returns zero counts
- Network timeout if the underlying Cosmos RPC is unreachable
- Payment failure if USDC balance is insufficient for the $0.10 fee

## How this service works

Cosmos wallet balance by bech32 address with chain auto-detected from prefix. Native balance + IBC token balances with raw ibc/hash denoms, IBC denom count, native flag. AI agent Cosmos portfolio tracker, IBC denom tracer, multi-chain wallet API.

## Output

Returns a structured response containing the wallet's native token balance, a list of IBC token balances with raw ibc/ hash denoms, an IBC denom count, a boolean flag indicating if a native denom is present, and pagination total. Chain is auto-detected from the bech32 prefix.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/proxy-suverse-io-2f6af549/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)