# Warden Protocol Network API
> Live on-chain data for Warden Protocol (chain-id warden_8765-1), an EVM-compatible Cosmos-SDK Layer 1 focused on intelligent on-chain applications and chain abstraction, with the WARD token. Read the current chain status — latest block height, block time and chain id — list the active validator set with each validator moniker, staked WARD, commission and jailed status, inspect the staking pool with bonded and not-bonded amounts and the bonded ratio, read the total WARD supply, and browse the latest on-chain governance proposals with their status and voting windows. WARD uses 18 decimals (EVM-style); all amounts are returned both in base units (award) and as whole WARD. Distinct from other Cosmos-chain APIs on the marketplace: this surfaces the Warden Protocol mainnet specifically.

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

## Pricing
- **Free** (Free) — 1,640 calls/Mo, 2 req/s
- **Basic** ($13/Mo) — 52,800 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 213,000 calls/Mo, 18 req/s
- **Scale** ($78/Mo) — 866,000 calls/Mo, 45 req/s

## Endpoints

### Chain

#### `GET /v1/status` — Chain status (latest block)

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

**Response:**
```json
{
    "data": {
        "height": 8083547,
        "symbol": "WARD",
        "num_txs": 1,
        "chain_id": "warden_8765-1",
        "decimals": 18,
        "block_time": "2026-06-15T11:15:14.522377475Z",
        "native_denom": "award",
        "proposer_address": "LqOTIjlO/Y7iRWjPmwZxQ2y0AMM="
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:17.937Z",
        "request_id": "bfd6b0b7-cbfe-43f6-9d7d-2ffe532a6703"
    },
    "status": "ok",
    "message": "Status retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/staking-pool` — Bonded / not-bonded staking pool

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

**Response:**
```json
{
    "data": {
        "bonded_ward": 91738979.893085,
        "bonded_award": "91738979893085434782604078",
        "bonded_ratio": 0.997455,
        "not_bonded_ward": 234045,
        "not_bonded_award": "234045000000000046000000"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:18.087Z",
        "request_id": "b3a2a67f-3bde-403f-869d-65c2a7f164c2"
    },
    "status": "ok",
    "message": "Staking pool retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Validator set

**Parameters:**
- `status` (query, optional, string) — Bond status filter Example: `BOND_STATUS_BONDED`

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

**Response:**
```json
{
    "data": {
        "count": 34,
        "status": "BOND_STATUS_BONDED",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": null,
                "moniker": "WardenLabs",
                "website": "https://wardenprotocol.org",
                "ward_tokens": 5286660.67613,
                "commission_rate": 0.1,
                "operator_address": "wardenvaloper1qvyu97ps4sgqnsapvdv9akkarythawx7927ukx"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "We operate state-of-the-art distributed and redundant validator and IBC relayer infrastructure for Proof of Stake Blockchains.",
                "moniker": "Crosnest",
                "website": "https://cros-nest.com",
                "ward_tokens": 4526043.62171,
                "commission_rate": 0.05,
                "operator_address": "wardenvaloper1sqmd7h42xvhlptdututaqs07xmzjxkjw39flus"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "The official validator node from Coinage (Coinage.Media) run by DAIC (https://daic.capital/telegram)",
                "moniker": "Coinage x DAIC",
                "website": "www.daic.capital",
                "ward_tokens": 4053124.999959,
                "commission_rate": 0.05,
                "operator_address": "wa
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "denom": "award",
        "symbol": "WARD",
        "decimals": 18,
        "total_ward": 1041000314.641332,
        "total_award": "1041000314641331662806199510"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:18.363Z",
        "request_id": "93a5a1a8-8f6f-4289-b182-c1f3b70ba85b"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Governance

#### `GET /v1/governance` — Latest governance proposals

**Parameters:**
- `limit` (query, optional, string) — Max proposals (1-50) Example: `10`

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

**Response:**
```json
{
    "data": {
        "count": 5,
        "proposals": [
            {
                "id": 5,
                "title": "Upgrade network to version v1.0.0",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "Upgrade Warden Protocol to version v1.0.0",
                "submit_time": "2026-03-16T13:34:50.431285542Z",
                "voting_end_time": "2026-03-18T13:24:50.431285542Z"
            },
            {
                "id": 4,
                "title": "Set Fixed 3% Inflation Rate",
                "status": "PROPOSAL_STATUS_REJECTED",
                "summary": "Sets inflation to a fixed 3% annual rate to address low circulating supply and staking participation. Both inflation_max and inflation_min are set to 3%, and inflation_rate_change is set to 0.",
                "submit_time": "2026-02-12T11:33:36.311948433Z",
                "voting_end_time": "2026-02-17T11:33:36.311948433Z"
            },
            {
                "id": 3,
                "title": "Increase transaction fees",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "Increase transaction fees to make the network less subject to attacks, while keeping them very affordable.",
                "submit_time": "2026-02-05T08:51:52.449746411Z",
                "voting_end_time": "2026-02-10T08:51:52.449746411Z"
            },
            {
                "id": 2,
                "title": "v0.7.4",
                "status": "PROPOSAL_STATUS_P
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "name": "Warden Protocol Network API",
        "source": "Warden Protocol public LCD/REST",
        "endpoints": [
            {
                "path": "/v1/status",
                "description": "Latest block height, time and chain id"
            },
            {
                "path": "/v1/validators",
                "description": "Validator set (?status=BOND_STATUS_BONDED)"
            },
            {
                "path": "/v1/staking-pool",
                "description": "Bonded / not-bonded staking pool and bonded ratio"
            },
            {
                "path": "/v1/supply",
                "description": "Total WARD supply"
            },
            {
                "path": "/v1/governance",
                "description": "Latest governance proposals (?limit=10)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public Warden Protocol LCD. Not affiliated with Warden Protocol. Data only; no guarantees of accuracy or availability.",
        "description": "On-chain data for Warden Protocol (chain-id warden_8765-1), an EVM-compatible Cosmos-SDK Layer 1 focused on intelligent applications and chain abstraction. Exposes chain status, the validator set, the staking pool, total WARD supply and governance proposals.",
        "native_token": {
            "denom": "award",
            "symb
…(truncated, see openapi.json for full schema)
```


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