# Cosmos Hub API
> Live on-chain data from the Cosmos Hub (ATOM), the flagship Cosmos-SDK / Tendermint chain and the hub of the inter-blockchain-communication ecosystem. The Cosmos Hub is a proof-of-stake chain built around validators and delegation. Resolve an address's liquid ATOM balance together with everything it has delegated, the validators it stakes to and its total staked amount. Read a validator's full state — its moniker and website, its voting power in ATOM, its commission rate and cap, whether it is bonded or jailed, and its self-described identity. Get the active validator set ranked by voting power. Read the live chain economics — the bonded and unbonded ATOM, the bonded ratio, the total ATOM supply, the current annual staking inflation, the community-pool balance and the active validator count. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Hedera, Kaspa, Solana and EVM on-chain APIs and from price feeds — this is Cosmos Hub account state, delegation, validators and staking economics. Perfect for wallets, explorers, staking dashboards and analytics apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cosmos-api/..."
```

## Pricing
- **Free** (Free) — 7,000 calls/Mo, 2 req/s
- **Starter** ($14/Mo) — 155,000 calls/Mo, 5 req/s
- **Pro** ($37/Mo) — 910,000 calls/Mo, 15 req/s
- **Business** ($85/Mo) — 4,800,000 calls/Mo, 40 req/s

## Endpoints

### Staking

#### `GET /v1/validator` — Validator full state

**Parameters:**
- `address` (query, required, string) — Validator address (cosmosvaloper1…) Example: `cosmosvaloper10sjr8xv2yr83agmzw7acf6xxqrw8e3q6wvh5ne`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmos-api/v1/validator?address=cosmosvaloper10sjr8xv2yr83agmzw7acf6xxqrw8e3q6wvh5ne"
```

**Response:**
```json
{
    "data": {
        "jailed": false,
        "source": "Cosmos Hub",
        "status": "BOND_STATUS_BONDED",
        "details": "Coinbase maintains world-class, enterprise-grade staking infrastructure across multiple networks with zero slashing events and a 99% uptime guarantee.",
        "moniker": "Coinbase01",
        "website": "https://coinbase.com/staking",
        "identity": "C73F1C17F994AB30",
        "delegator_shares": 65420964.62,
        "operator_address": "cosmosvaloper10sjr8xv2yr83agmzw7acf6xxqrw8e3q6wvh5ne",
        "voting_power_atom": 65420964.615892,
        "commission_max_pct": 100,
        "commission_rate_pct": 20
    },
    "meta": {
        "timestamp": "2026-06-10T05:17:38.101Z",
        "request_id": "7edd7e83-3679-4946-b152-4b4dd2b43901"
    },
    "status": "ok",
    "message": "Validator retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Active validator set by voting power

**Parameters:**
- `limit` (query, optional, string) — Max 1-200 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmos-api/v1/validators?limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "source": "Cosmos Hub",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "Coinbase maintains world-class, enterprise-grade staking infrastructure across multiple networks with zero slashing events and a 99% uptime guarantee.",
                "moniker": "Coinbase01",
                "website": "https://coinbase.com/staking",
                "identity": "C73F1C17F994AB30",
                "delegator_shares": 65420964.62,
                "operator_address": "cosmosvaloper10sjr8xv2yr83agmzw7acf6xxqrw8e3q6wvh5ne",
                "voting_power_atom": 65420964.615892,
                "commission_max_pct": 100,
                "commission_rate_pct": 20
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "The Most Trusted Digital-Asset Exchange",
                "moniker": "Upbit Staking",
                "website": "https://upbit.com",
                "identity": "58BF2A0CBC9230B9",
                "delegator_shares": 23451263.66,
                "operator_address": "cosmosvaloper1x8efhljzvs52u5xa6m7crcwes7v9u0nlwdgw30",
                "voting_power_atom": 23451263.65692,
                "commission_max_pct": 100,
                "commission_rate_pct": 100
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BO
…(truncated, see openapi.json for full schema)
```

### Account

#### `GET /v1/account` — Account balance + delegations

**Parameters:**
- `address` (query, required, string) — Cosmos address (cosmos1…) Example: `cosmos1qr5dk7g8grg80wgveww88fuwut9ry8wmjvnsad`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmos-api/v1/account?address=cosmos1qr5dk7g8grg80wgveww88fuwut9ry8wmjvnsad"
```

**Response:**
```json
{
    "data": {
        "source": "Cosmos Hub",
        "address": "cosmos1qr5dk7g8grg80wgveww88fuwut9ry8wmjvnsad",
        "delegations": [
            {
                "validator": "cosmosvaloper10sjr8xv2yr83agmzw7acf6xxqrw8e3q6wvh5ne",
                "amount_atom": 20395.43348
            }
        ],
        "staked_atom": 20395.43348,
        "available_atom": 0.135466,
        "delegation_count": 1
    },
    "meta": {
        "timestamp": "2026-06-10T05:17:38.456Z",
        "request_id": "09c5a801-7347-4cf5-a2d0-c59f68712c9f"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

### Network

#### `GET /v1/network` — Live chain economics

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmos-api/v1/network"
```

**Response:**
```json
{
    "data": {
        "chain": "cosmoshub",
        "source": "Cosmos Hub",
        "bonded_atom": 320772508.982067,
        "inflation_pct": 10,
        "not_bonded_atom": 15133528.65985,
        "bonded_ratio_pct": 62.4986,
        "total_supply_atom": 513247352.326619,
        "community_pool_atom": 10427828.337909,
        "bonded_validator_count": 200
    },
    "meta": {
        "timestamp": "2026-06-10T05:17:38.845Z",
        "request_id": "2f26bfb9-dca0-4430-a8e1-abafb35b7325"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/cosmos-api
OpenAPI spec: https://www.oanor.com/api/cosmos-api/openapi.json