# Chihuahua Chain API
> Real-time on-chain data for Chihuahua (chain-id chihuahua-1), a community-driven Cosmos-SDK Layer-1 secured by delegated proof-of-stake with HUAHUA as its native coin. The status endpoint returns the chain id, latest block height and time, proposer and node application version so you can confirm the chain is live and producing blocks. The validators endpoint returns the full bonded validator set — each moniker, operator address, stake in HUAHUA, commission rate and jailed flag — sorted by stake, plus the total bonded and not-bonded HUAHUA. The supply endpoint returns the total HUAHUA supply (in HUAHUA and base uhuahua), the bonded amount and the bonded ratio. The governance endpoint returns the most recent on-chain governance proposals with title, status and voting window. The meta endpoint documents the chain, denom and decimals. Reads a live Chihuahua Cosmos-SDK LCD node directly (with mirror fallback), so values are current to the latest block. Live, nothing stored. 5 endpoints. This serves chain-level staking, supply and governance data; for token prices or NFTs use a dedicated market/indexer API.

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

## Pricing
- **Free** (Free) — 260 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 22,000 calls/Mo, 5 req/s
- **Pro** ($34/Mo) — 119,000 calls/Mo, 20 req/s
- **Mega** ($74/Mo) — 535,000 calls/Mo, 60 req/s

## Endpoints

### Chain

#### `GET /v1/status` — Chain status: latest block, chain id, node version

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

**Response:**
```json
{
    "data": {
        "chain": "Chihuahua",
        "healthy": true,
        "chain_id": "chihuahua-1",
        "native_symbol": "HUAHUA",
        "node_app_version": "v9.0.7",
        "proposer_address": "Ld9PNkIM6GGmNwAfnOlz4PfbmH4=",
        "latest_block_time": "2026-06-15T20:40:05.456292579Z",
        "latest_block_height": 23982329
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:37.630Z",
        "request_id": "0838ec3b-88c8-48c5-9ef7-f3a9dc3c8bff"
    },
    "status": "ok",
    "message": "Chain status retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/supply` — Total HUAHUA supply and bonded ratio

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

**Response:**
```json
{
    "data": {
        "chain": "Chihuahua",
        "denom": "uhuahua",
        "decimals": 6,
        "bonded_huahua": "21160053068.465489",
        "native_symbol": "HUAHUA",
        "bonded_ratio_pct": 17.36,
        "total_supply_huahua": "121829294369.340811",
        "total_supply_uhuahua": "121829294369340811"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:37.705Z",
        "request_id": "c5ee3d78-1c20-4a8b-92c7-213c14d7c2fd"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Bonded validator set with stake and commission

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

**Response:**
```json
{
    "data": {
        "chain": "Chihuahua",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Cosmostation",
                "tokens_huahua": "3882043662.905187",
                "tokens_uhuahua": "3882043662905187",
                "commission_rate": 0.05,
                "operator_address": "chihuahuavaloper1tgcypttehx3afugys6eq28h0kpmswfkgtten6j"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Stakecito Labs",
                "tokens_huahua": "3480969728.48426",
                "tokens_uhuahua": "3480969728484260",
                "commission_rate": 0.1,
                "operator_address": "chihuahuavaloper1qe8uuf5x69c526h4nzxwv4ltftr73v7qshf22j"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "The_Cybernetics",
                "tokens_huahua": "2908455785.576153",
                "tokens_uhuahua": "2908455785576153",
                "commission_rate": 0.05,
                "operator_address": "chihuahuavaloper1cjnwtpj27hpd3ztyuf43um5jgew63p9nh4jjd3"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "  polkachu.com",
                "tokens_huahua": "1711905342.003559",
                "tokens_uhuahua": "1711905342
…(truncated, see openapi.json for full schema)
```

### Governance

#### `GET /v1/governance` — Recent on-chain governance proposals

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

**Response:**
```json
{
    "data": {
        "chain": "Chihuahua",
        "count": 10,
        "proposals": [
            {
                "id": "98",
                "title": "Recover Expired IBC Client 07-tendermint-45 (Osmosis)",
                "status": "PROPOSAL_STATUS_FAILED",
                "summary": "This proposal recovers the expired IBC client 07-tendermint-45 connecting Chihuahua to Osmosis by updating it with the active state of substitute client 07-tendermint-224.",
                "submit_time": "2026-05-25T21:08:33.960019737Z",
                "voting_end_time": "2026-05-30T21:08:33.960019737Z"
            },
            {
                "id": "97",
                "title": "Leash the Inflation: Taking $HUAHUA to 0% for Maximum Chill!",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "Our beloved $HUAHUA is tired of the inflation treadmill. This proposal slashes the inflation rate to a flat 0% to transform Chihuahua from an hyperactive puppy into a stable, well-fed couch coin. Zero inflation means every $HUAHUA you hold ",
                "submit_time": "2025-12-05T08:14:22.284455643Z",
                "voting_end_time": "2025-12-10T08:14:22.284455643Z"
            },
            {
                "id": "96",
                "title": "Upgrade v9.0.6",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "This governance proposal is for an on-chain upgrade to Chihuahua **v9.0.6**",
                "submit_time": "2025-10
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Chain metadata

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

**Response:**
```json
{
    "data": {
        "type": "Cosmos-SDK Layer-1 (Tendermint/CometBFT)",
        "chain": "Chihuahua",
        "denom": "uhuahua",
        "chain_id": "chihuahua-1",
        "decimals": 6,
        "ecosystem": "Chihuahua — a community-driven Cosmos-SDK Layer-1, native coin HUAHUA, secured by delegated proof-of-stake.",
        "endpoints": [
            "/v1/status",
            "/v1/validators",
            "/v1/supply",
            "/v1/governance",
            "/v1/meta"
        ],
        "documentation": "https://chihuahua-api.oanor.dev",
        "native_symbol": "HUAHUA"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:37.952Z",
        "request_id": "e6705bd4-04d9-4184-8a34-e7f8b4ee0f14"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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