# Desmos API
> Live on-chain data for Desmos (chain id desmos-mainnet) — the Cosmos-SDK Layer-1 purpose-built for decentralised social networking, whose native token is DSM — served directly from public LCD/REST nodes with multi-node failover. The status endpoint returns the latest block height and time, chain id, the staking bond denom and the current minting inflation rate. The validators endpoint lists the active bonded validator set ranked by stake, each with its moniker, operator address, self-plus-delegated DSM, commission rate and jailed flag. The supply endpoint returns the total DSM supply, the amount bonded in staking and the resulting bonded ratio. The governance endpoint returns the most recent on-chain proposals with their id, title, status and voting window. Token amounts are converted from base micro-DSM (6 decimals) into whole DSM, and every figure is read live from the chain — nothing bundled or modelled — behind a short server-side cache with keep-warm so the feed stays fast and fresh. Ideal for staking dashboards, validator and delegator tooling, explorers, governance trackers and portfolio or analytics apps across the Cosmos and decentralised-social ecosystem. Live keyless upstream. 5 endpoints.

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

## Pricing
- **Free** (Free) — 310 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 14,600 calls/Mo, 8 req/s
- **Pro** ($38/Mo) — 79,000 calls/Mo, 16 req/s
- **Mega** ($91/Mo) — 320,000 calls/Mo, 40 req/s

## Endpoints

### Desmos

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

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

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

**Response:**
```json
{
    "data": {
        "chain": "Desmos",
        "count": 15,
        "symbol": "DSM",
        "proposals": [
            {
                "id": "50",
                "title": "Recover IBC client to Osmosis",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-01-04T18:04:14.436515792Z",
                "voting_end_time": "2026-01-11T18:04:14.436515792Z"
            },
            {
                "id": "49",
                "title": "Signal Proposal to Shut Down Desmos Chain",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2024-05-23T23:24:34.702812113Z",
                "voting_end_time": "2024-05-30T23:24:34.702812113Z"
            },
            {
                "id": "48",
                "title": "Desmos v7.1.0 upgrade",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2024-04-26T15:02:57.190911153Z",
                "voting_end_time": "2024-05-03T15:42:28.070816145Z"
            },
            {
                "id": "46",
                "title": "Community Spend Proposal",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2024-04-22T00:03:51.478395503Z",
                "voting_end_time": "2024-04-29T00:03:51.478395503Z"
            },
            {
                "id": "45",
                "title": "💎ATOM Airdrop ✅  - Cosmos Hub Proposal ⭐",
                "status": "PROPOSAL_STATUS_REJECTED",
             
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/status` — Chain status

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

**Response:**
```json
{
    "data": {
        "chain": "Desmos",
        "source": "Desmos LCD",
        "symbol": "DSM",
        "chain_id": "desmos-mainnet",
        "bond_denom": "udsm",
        "inflation_pct": 3,
        "latest_block_time": "2026-06-15T20:40:20.401242640Z",
        "latest_block_height": 29367826
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:24.475Z",
        "request_id": "61769ff0-c8d4-4acf-8052-4aebce62b7a4"
    },
    "status": "ok",
    "message": "Desmos status retrieved",
    "success": true
}
```

#### `GET /v1/supply` — DSM supply & bonded ratio

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

**Response:**
```json
{
    "data": {
        "chain": "Desmos",
        "denom": "udsm",
        "bonded": 74976502.600703,
        "symbol": "DSM",
        "decimals": 6,
        "total_supply": 192522452.203756,
        "bonded_ratio_pct": 38.94
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:24.719Z",
        "request_id": "72e2d801-843b-4bd6-a72c-d7588c4020ae"
    },
    "status": "ok",
    "message": "Desmos supply retrieved",
    "success": true
}
```

#### `GET /v1/validators` — Active validator set

**Parameters:**
- `limit` (query, optional, string) — Max validators to return (1-300) Example: `100`

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

**Response:**
```json
{
    "data": {
        "chain": "Desmos",
        "count": 20,
        "symbol": "DSM",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 18816531.53392,
                "moniker": "Apollo",
                "commission_pct": 100,
                "operator_address": "desmosvaloper17lca9smrdlwkznr92hypzrgsjkelnxeaacgrwq"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 17182728.449672,
                "moniker": "Athena",
                "commission_pct": 100,
                "operator_address": "desmosvaloper10m2n5g7ekune734su9sepyn2898cgv5emec320"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 14026777.30363,
                "moniker": "Poseidon",
                "commission_pct": 100,
                "operator_address": "desmosvaloper16fc5kd5d4f5sjq5wz3v8gkyk4xd8f7hrrtz2vu"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 11037929.210162,
                "moniker": "Artemis",
                "commission_pct": 100,
                "operator_address": "desmosvaloper1l9zft6jwgn25tyjl4ry8jyyy67lng49cdpxmk9"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
           
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "api": "Desmos API",
        "chain": "Desmos",
        "denom": "udsm",
        "source": "Desmos public LCD/REST nodes (Cosmos SDK)",
        "symbol": "DSM",
        "chain_id": "desmos-mainnet",
        "decimals": 6,
        "endpoints": [
            "/v1/status",
            "/v1/validators",
            "/v1/supply",
            "/v1/governance",
            "/v1/meta"
        ],
        "description": "Live on-chain data for Desmos — the Cosmos-SDK Layer-1 for decentralised social networking (DSM).",
        "documentation": "https://desmos-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:25.088Z",
        "request_id": "264eb0e3-ff0a-47df-a0c1-c2d3330d88d4"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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