# Cosmos Hub / Osmosis / Celestia Wallet Portfolio Lookup

> Cosmos Hub / Osmosis / Celestia Wallet Portfolio Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns token balances, staked amounts per validator, pending rewards, unbonding amounts, and USD value for a Cosmos ecosystem wallet or validator address

## Facts

- Endpoint: POST https://api.vextorium.com/v1/cosmos-wallet?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cosmos-hub-osmosis-celestia-wallet-portfolio-lookup-2ca36c28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t3Y0WjcAC_WP_UyvyMEF5

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 cosmos-hub-osmosis-celestia-wallet-portfolio-lookup-2ca36c28 -d '<json body>'
```

Example prompt: Can you check my Cosmos Hub wallet cosmos1qphf0ferqcch0jca9hlqfm3x0eds3dpkac4g9j and tell me how much ATOM I have available, how much is staked, which validators I'm delegating to, any pending rewards, and the total value in USD?

## When to prefer this

Use this endpoint when you need a comprehensive, all-in-one snapshot of a Cosmos ecosystem wallet including staking, delegations, rewards, unbonding, and USD valuation — specifically for Cosmos Hub (ATOM), Osmosis (OSMO), or Celestia (TIA) addresses. Prefer this over generic block explorers when you need structured, machine-readable data ready for agent consumption without parsing HTML. Also useful for looking up a validator's account details from a valoper address.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Address on an unsupported network (not Cosmos Hub, Osmosis, or Celestia) may return null or an error
- Public REST node downtime may cause failures or stale data
- Validator valoper address on unsupported network returns no data
- Rate limiting or payment failure (x402) returns a 402 or 429 error

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with: available token balance, staked amount, pending rewards, unbonding amount, list of delegations (validator address + amount each), total token balance, token symbol, network name, current USD price, total portfolio value in USD, and the data source used (public REST nodes + DefiLlama pricing).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 3.565708,
  "source": "Public REST nodes (publicnode); price: DefiLlama",
  "staked": 0.999908,
  "symbol": "ATOM",
  "account": "cosmos1qphf0ferqcch0jca9hlqfm3x0eds3dpkac4g9j",
  "network": "cosmos",
  "available": 2.565585,
  "price_usd": 1.673398018424324,
  "unbonding": 0,
  "delegations": [
   {
    "amount": 0.999908,
    "validator": "cosmosvaloper1qphf0ferqcch0jca9hlqfm3x0eds3dpkcvpafp"
   }
  ],
  "other_tokens": [],
  "pending_rewards": 0.000215,
  "total_value_usd": 5.97
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cosmos-hub-osmosis-celestia-wallet-portfolio-lookup-2ca36c28/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)