# Cosmos Chain API
> Read the live economic state of any Cosmos SDK chain from public LCD/REST endpoints — no key — across the Cosmos Hub, Osmosis, Celestia, Injective, Juno and dozens more via one chain parameter. The staking endpoint returns the network's bonded and unbonded tokens, the bonded ratio (how much of the supply is securing the chain) and its current inflation; the governance endpoint returns the latest on-chain proposals with their status and voting timeline; and the supply endpoint returns the total supply of the chain's staking token plus its community pool. Distinct from validator- and account-level APIs: this is the chain-economics and governance layer for Cosmos wallets, stakers, dashboards, validators and analytics. Live; short cache only.

## 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/cosmoschain-api/..."
```

## Pricing
- **Free** (Free) — 6,400 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 122,000 calls/Mo, 8 req/s
- **Pro** ($35/Mo) — 748,000 calls/Mo, 20 req/s
- **Business** ($98/Mo) — 4,720,000 calls/Mo, 50 req/s

## Endpoints

### Cosmos

#### `GET /v1/governance` — Latest governance proposals (optional status=voting)

**Parameters:**
- `chain` (query, optional, string) — Chain name Example: `cosmoshub`
- `status` (query, optional, string) — Filter: voting (only active) or all
- `limit` (query, optional, string) — How many (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmoschain-api/v1/governance?chain=cosmoshub&limit=10"
```

**Response:**
```json
{
    "data": {
        "note": "The chain's most recent governance proposals (newest first). Pass status=voting to get only proposals currently in the voting period.",
        "chain": "cosmoshub",
        "count": 10,
        "filter": "all",
        "source": "Cosmos LCD",
        "proposals": [
            {
                "id": "1042",
                "title": "✅ Gaia v27.4.0 - 💎$ATOM Airdrop ⭐",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2026-06-06T12:43:30.381715995Z",
                "total_deposit": [
                    {
                        "denom": "uatom",
                        "amount": "500000000"
                    }
                ],
                "voting_end_time": "2026-06-13T12:43:30.381715995Z"
            },
            {
                "id": "1041",
                "title": "Gaia v27.4.0 Upgrade",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-06-02T14:32:19.685688321Z",
                "total_deposit": [
                    {
                        "denom": "uatom",
                        "amount": "500000000"
                    }
                ],
                "voting_end_time": "2026-06-09T14:39:57.339562365Z"
            },
            {
                "id": "1040",
                "title": "💎ATOM Airdrop ✅ - Play & WIN Airdrops ⭐ 2026",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2026-05-30
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/staking` — Bonded/unbonded tokens, bonded ratio, inflation

**Parameters:**
- `chain` (query, optional, string) — Chain name (cosmoshub, osmosis, celestia, injective...) Example: `cosmoshub`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmoschain-api/v1/staking?chain=cosmoshub"
```

**Response:**
```json
{
    "data": {
        "note": "Network staking state: bonded vs not-bonded tokens (in the chain's base denom), the bonded ratio, and current inflation. Some chains do not run the mint module, so inflation can be null.",
        "chain": "cosmoshub",
        "source": "Cosmos LCD",
        "inflation": 0.1,
        "bond_denom": "uatom",
        "bonded_ratio": 0.9527149386940329,
        "bonded_tokens": "320640054024365",
        "inflation_pct": 10,
        "max_validators": 200,
        "unbonding_time": "1814400s",
        "not_bonded_tokens": "15913978038881"
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:55.441Z",
        "request_id": "6059e2ff-f903-4ed7-973b-26761e45a70b"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

#### `GET /v1/supply` — Total supply of the staking denom + community pool

**Parameters:**
- `chain` (query, optional, string) — Chain name Example: `cosmoshub`
- `denom` (query, optional, string) — Override denom (defaults to staking denom)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cosmoschain-api/v1/supply?chain=cosmoshub"
```

**Response:**
```json
{
    "data": {
        "note": "Total supply of the chain's staking/base denom and the amount in its community pool (raw integer amounts in the base denom).",
        "chain": "cosmoshub",
        "denom": "uatom",
        "source": "Cosmos LCD",
        "total_supply": "513975642561317",
        "community_pool": "10442400074534.445770926332304818"
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:55.615Z",
        "request_id": "c2d88938-871a-4748-8d60-e1fee7a356ac"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata & live sample

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

**Response:**
```json
{
    "data": {
        "sample": {
            "chain": "cosmoshub",
            "bonded_ratio": 0.9527149386940329
        },
        "source": "public Cosmos LCD/REST (cosmos.directory proxy), keyless",
        "service": "cosmoschain-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/supply": "Total supply of the staking denom + community pool (chain, optional denom).",
            "GET /v1/staking": "Bonded/unbonded tokens, bonded ratio, inflation (chain=cosmoshub).",
            "GET /v1/governance": "Latest governance proposals, optional status=voting (chain, limit)."
        },
        "description": "Read the live economic state of any Cosmos SDK chain from public LCD/REST: staking (bonded/unbonded, bonded ratio, inflation), governance proposals, and token supply + community pool — across Cosmos Hub, Osmosis, Celestia, Injective, Juno and more via one chain parameter. The chain-economics and governance layer for Cosmos wallets, stakers and dashboards. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:55.688Z",
        "request_id": "b02ba8f8-f44a-4ef9-831c-4ce56b62ccf2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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