# Dymension RollApp On-Chain API
> Live on-chain data for Dymension (the modular RollApp settlement layer L1, chain dymension_1100-1) with no key: the RollApp registry (every RollApp on the hub, with id, owner, description and website), the Dymension hub staking economics (bonded vs unbonded DYM, bonded ratio, parameters), the active validator set, the total DYM 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/dymension-api/..."
```

## Pricing
- **Free** (Free) — 7,300 calls/Mo, 2 req/s
- **Basic** ($29/Mo) — 181,000 calls/Mo, 10 req/s
- **Pro** ($85/Mo) — 1,030,000 calls/Mo, 20 req/s
- **Scale** ($159/Mo) — 5,640,000 calls/Mo, 50 req/s

## Endpoints

### RollApps

#### `GET /v1/rollapps` — RollApp registry — every RollApp on the hub

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

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

**Response:**
```json
{
    "data": {
        "note": "Dymension's RollApp registry — every RollApp deployed on the hub, with its id, owner address, description and website. Pass limit (1-100, default 25). RollApps are the app-specific rollup chains that settle on Dymension.",
        "count": 25,
        "source": "Dymension (dymension_1100-1) LCD",
        "rollapps": [
            {
                "owner": "dym1cw6e63gd4mduv9eduxf9fp8pjs8hfmx5d8q48t",
                "website": null,
                "channel_id": null,
                "rollapp_id": "a_907975-1",
                "description": null
            },
            {
                "owner": "dym1hn5l4rsqd4zn2zgfh7du7egj6fv874e684kfn8",
                "website": null,
                "channel_id": null,
                "rollapp_id": "aaaaaa_811707-1",
                "description": "aaaaaa"
            },
            {
                "owner": "dym1x84t0tyeqw7h3xf3ahljyr07pyd875a3v6xy8z",
                "website": null,
                "channel_id": null,
                "rollapp_id": "aalexsssss_319572-1",
                "description": null
            },
            {
                "owner": "dym1lms4ykjcxww8x08xztlajyrue8480elaw2v96f",
                "website": "https://x.com/himakiti2022",
                "channel_id": null,
                "rollapp_id": "aatititigfsd_196433-1",
                "description": null
            },
            {
                "owner": "dym1xwkzhh4heh762ur28zwxu32zge225nvy4m3g7a",
           
…(truncated, see openapi.json for full schema)
```

### Staking

#### `GET /v1/staking` — Dymension hub staking economics & parameters

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

**Response:**
```json
{
    "data": {
        "note": "The Dymension hub staking economics — bonded vs unbonded DYM, the bonded ratio, and the staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "adym",
            "max_validators": 125,
            "min_commission_rate": 0.05,
            "unbonding_time_seconds": 1814400
        },
        "source": "Dymension (dymension_1100-1) LCD",
        "bonded_dym": 134111164.1,
        "not_bonded_dym": 18677490.38,
        "bonded_ratio_percent": 87.78
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:29.700Z",
        "request_id": "d176583b-413c-4170-8ff3-b4cb5ffe2392"
    },
    "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/dymension-api/v1/validators?limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "The active Dymension validator set, ranked by voting power — each validator's moniker, website, voting power (in DYM), commission rate and status. Pass limit (1-100, default 25).",
        "count": 25,
        "source": "Dymension (dymension_1100-1) LCD",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Kraken",
                "website": "https://www.kraken.com/",
                "commission_rate": 0.05,
                "operator_address": "dymvaloper15yh22qgvswsa4hg7k3ga8759m5s56a8mur5lls",
                "voting_power_dym": 23577899.19
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Encode Club",
                "website": "https://www.encode.club/",
                "commission_rate": 0.05,
                "operator_address": "dymvaloper1m6qqexve6afkr8v25895ccjegc0k2zeladeyhh",
                "voting_power_dym": 15567327.11
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "MZONDER",
                "website": null,
                "commission_rate": 0.15,
                "operator_address": "dymvaloper16vz54egcjh7du0wq04yssk6gzlefu6yw230gg6",
                "voting_power_dym": 12151348.24
            },
            {
                "jailed": false,
               
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of DYM (the native token of Dymension), in both DYM and the adym base denomination (18 decimals). No parameters.",
        "denom": "DYM",
        "source": "Dymension (dymension_1100-1) LCD",
        "decimals": 18,
        "base_denom": "adym",
        "total_supply_dym": 1067198517.09,
        "total_supply_adym": "1067198517085641202604540873"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:30.004Z",
        "request_id": "dad2e9c5-cdcd-44fc-a06b-34459ce7bea4"
    },
    "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/dymension-api/v1/block"
```

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Dymension block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:20.050501570Z",
        "height": 21255606,
        "source": "Dymension (dymension_1100-1) LCD",
        "num_txs": 0,
        "chain_id": "dymension_1100-1",
        "proposer_address": "xlK9eqJX/yMOE8wWWC4OOYkPXks="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:30.134Z",
        "request_id": "ef994e61-969f-4968-a2c1-2f3789560b1d"
    },
    "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/dymension-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "latest_height": 21255606
        },
        "source": "Dymension public Cosmos REST / LCD nodes (dymension-api.polkachu.com and mirrors), keyless",
        "service": "dymension-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/supply": "Total DYM supply.",
            "GET /v1/staking": "Dymension hub staking economics & parameters.",
            "GET /v1/rollapps": "RollApp registry — every RollApp on the hub (limit).",
            "GET /v1/validators": "Active validator set (limit)."
        },
        "description": "Live on-chain data for Dymension (the modular RollApp settlement layer L1, chain dymension_1100-1) with no key: the RollApp registry (every RollApp on the hub, with id, owner, description and website), the Dymension hub staking economics (bonded vs unbonded DYM, bonded ratio, parameters), the active validator set, the total DYM supply, and the latest block. The Dymension-RollApp / on-chain / staking layer for explorers, ecosystem dashboards and research. Distinct from other chain readers — Dymension and its RollApp registry. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:30.262Z",
        "request_id": "de1f6110-f0e3-4598-9c87-19006cd93585"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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