# Kujira On-Chain API
> Live on-chain data for Kujira (the zero-inflation, fee-funded Cosmos DeFi L1, chain kaiyo-1) with no key: the on-chain price oracle (validator-fed USD exchange rates for dozens of assets), the Kujira chain staking economics (no inflation; fee-funded), the active validator set, the total KUJI supply, and the latest block.

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

## Pricing
- **Free** (Free) — 7,700 calls/Mo, 2 req/s
- **Basic** ($27/Mo) — 189,000 calls/Mo, 10 req/s
- **Pro** ($79/Mo) — 1,070,000 calls/Mo, 20 req/s
- **Scale** ($152/Mo) — 5,870,000 calls/Mo, 50 req/s

## Endpoints

### Oracle

#### `GET /v1/oracle` — On-chain price oracle (USD rates per asset)

**Parameters:**
- `denom` (query, optional, string) — Filter by symbol(s), comma-separated Example: `ATOM,AKT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kujira-api/v1/oracle?denom=ATOM%2CAKT"
```

**Response:**
```json
{
    "data": {
        "note": "Kujira's on-chain price oracle — the validator-fed exchange rate (in USD) for each tracked asset. Optionally pass denom (a symbol or comma-separated symbols, e.g. ATOM,AKT) to filter; omit it for all rates.",
        "count": 2,
        "rates": [
            {
                "denom": "AKT",
                "usd_rate": 0.831915
            },
            {
                "denom": "ATOM",
                "usd_rate": 1.99217
            }
        ],
        "source": "Kujira (kaiyo-1) LCD"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:31.263Z",
        "request_id": "7e84ac10-b34e-4da0-9ce2-cd97f204daf4"
    },
    "status": "ok",
    "message": "Oracle retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/staking` — Kujira chain staking economics (no inflation)

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

**Response:**
```json
{
    "data": {
        "note": "The Kujira chain staking economics — bonded vs unbonded KUJI, the bonded ratio, and the staking parameters. Kujira is fee-funded with no inflation. No parameters.",
        "params": {
            "bond_denom": "ukuji",
            "max_validators": 75,
            "min_commission_rate": 0,
            "unbonding_time_seconds": 1209600
        },
        "source": "Kujira (kaiyo-1) LCD",
        "bonded_kuji": 3323255.79,
        "inflation_note": "Kujira has zero token inflation; validators and stakers are rewarded from protocol fees, not new issuance.",
        "not_bonded_kuji": 9313843.16,
        "bonded_ratio_percent": 26.3
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:31.397Z",
        "request_id": "247331f3-1d7a-4f53-a163-681b117e6014"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

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

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

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

**Response:**
```json
{
    "data": {
        "note": "The active Kujira validator set, ranked by voting power — each validator's moniker, website, voting power (in KUJI), commission rate and status. Pass limit (1-100, default 25).",
        "count": 8,
        "source": "Kujira (kaiyo-1) LCD",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "KujiDAO",
                "website": "https://twitter.com/kuji_DAO",
                "commission_rate": 0.05,
                "operator_address": "kujiravaloper1546l88y0g9ch5v25dg4lmfewgelsd3v966qj3y",
                "voting_power_kuji": 598498.94
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Active Nodes",
                "website": "https://www.activenodes.io",
                "commission_rate": 0.09,
                "operator_address": "kujiravaloper10es7svzdyn4v2gnwtxq4gsu6q8qaelff8gkflr",
                "voting_power_kuji": 408239.14
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "PFC - Plan For Chaos",
                "website": "https://pfc.zone/",
                "commission_rate": 0.2,
                "operator_address": "kujiravaloper1670dvuv348eynr9lsmdrhqu3g7vpmzx9ugf8fk",
                "voting_power_kuji": 397617.11
            },
            {
                "jail
…(truncated, see openapi.json for full schema)
```

### Supply

#### `GET /v1/supply` — Total KUJI supply

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of KUJI (the native token of Kujira), in both KUJI and the ukuji micro-denomination. No parameters.",
        "denom": "KUJI",
        "source": "Kujira (kaiyo-1) LCD",
        "micro_denom": "ukuji",
        "total_supply_kuji": 122340604.39,
        "total_supply_ukuji": "122340604385696"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:31.643Z",
        "request_id": "e9b3753a-c332-4bc1-8d16-a71f3fa0af2f"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Chain

#### `GET /v1/block` — Latest block

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

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Kujira block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:17.950554495Z",
        "height": 36221796,
        "source": "Kujira (kaiyo-1) LCD",
        "num_txs": 0,
        "chain_id": "kaiyo-1",
        "proposer_address": "mABtN+LMsvYs6jPckGXBbKadHwo="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:31.772Z",
        "request_id": "2a58a2d8-6099-4402-8e57-021c02eadb42"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata & endpoint catalog

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

**Response:**
```json
{
    "data": {
        "sample": {
            "oracle_denoms": 54
        },
        "source": "Kujira public Cosmos REST / LCD nodes (kujira-api.polkachu.com and mirrors), keyless",
        "service": "kujira-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/oracle": "On-chain price oracle — USD rates per asset (denom filter optional).",
            "GET /v1/supply": "Total KUJI supply.",
            "GET /v1/staking": "Kujira chain staking economics & parameters (no inflation).",
            "GET /v1/validators": "Active validator set (limit)."
        },
        "description": "Live on-chain data for Kujira (the zero-inflation, fee-funded Cosmos DeFi L1, chain kaiyo-1) with no key: the on-chain price oracle (validator-fed USD exchange rates for dozens of assets), the Kujira chain staking economics (no inflation; fee-funded), the active validator set, the total KUJI supply, and the latest block. The Kujira-on-chain / oracle / staking layer for DeFi dashboards, price feeds and research. Distinct from other chain readers — Kujira and its on-chain price oracle. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:31.851Z",
        "request_id": "ba680cd0-9b6d-4659-b38d-f061c8c3a3cc"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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