# cheqd Chain API
> Real-time on-chain data for cheqd (chain-id cheqd-mainnet-1), a Cosmos-SDK Layer-1 purpose-built for decentralised identity, verifiable credentials and trust registries, with CHEQ as its native coin (base denom ncheq, 9 decimals), secured by delegated proof-of-stake. 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 CHEQ, commission rate and jailed flag — sorted by stake, plus the total bonded and not-bonded CHEQ. The supply endpoint returns the total CHEQ supply (in CHEQ and base ncheq), 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 cheqd 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 DID documents or credential resolution use a dedicated cheqd resolver 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/cheqd-api/..."
```

## Pricing
- **Free** (Free) — 270 calls/Mo, 2 req/s
- **Basic** ($13/Mo) — 22,700 calls/Mo, 5 req/s
- **Pro** ($35/Mo) — 118,500 calls/Mo, 20 req/s
- **Mega** ($77/Mo) — 538,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/cheqd-api/v1/status"
```

### Staking

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

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

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

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

### Governance

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

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

### Meta

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

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


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