# MANTRA Chain On-Chain API
> Live on-chain data for MANTRA Chain (the real-world-asset (RWA) tokenization L1, chain mantra-1) with no key: staking economics (bonded vs unbonded OM, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total OM supply, monetary inflation (annual rate, annual provisions, mint parameters), the latest governance proposals, 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/mantra-api/..."
```

## Pricing
- **Free** (Free) — 6,900 calls/Mo, 2 req/s
- **Basic** ($34/Mo) — 173,000 calls/Mo, 10 req/s
- **Pro** ($92/Mo) — 990,000 calls/Mo, 20 req/s
- **Scale** ($164/Mo) — 5,410,000 calls/Mo, 50 req/s

## Endpoints

### Staking

#### `GET /v1/staking` — Staking economics & parameters

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

**Response:**
```json
{
    "data": {
        "note": "The MANTRA staking economics — bonded vs unbonded OM, the bonded ratio, and the chain's staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "amantra",
            "max_validators": 38,
            "min_commission_rate": 0,
            "unbonding_time_seconds": 691200
        },
        "source": "MANTRA (mantra-1) LCD",
        "bonded_om": 1946051761.92,
        "not_bonded_om": 9882174.76,
        "bonded_ratio_percent": 99.49
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:25.892Z",
        "request_id": "35f30960-e339-4f7e-81a2-9c2f8557a374"
    },
    "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/mantra-api/v1/validators?limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "The active MANTRA validator set, ranked by voting power — each validator's moniker, website, voting power (in OM), commission rate and status. Pass limit (1-100, default 25).",
        "count": 25,
        "source": "MANTRA (mantra-1) LCD",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Association 2",
                "website": "https://mantrachain.io",
                "commission_rate": 0,
                "voting_power_om": 326505069.86,
                "operator_address": "mantravaloper186ec68jh7lfu7g8nnm8u6fjlez8xpsl84c737q"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Association 3",
                "website": "https://mantrachain.io",
                "commission_rate": 0,
                "voting_power_om": 233816270.26,
                "operator_address": "mantravaloper1l4y7m2hgtjzwxl8758q38x0s8e8kflsx55rvt3"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Association 1",
                "website": "https://mantrachain.io",
                "commission_rate": 0,
                "voting_power_om": 219858153.05,
                "operator_address": "mantravaloper1y8hxa8q0qk6h2fxtugkx67re38k03888eeqmpd"
            },
            {
                "jailed": false
…(truncated, see openapi.json for full schema)
```

### Governance

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

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

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

**Response:**
```json
{
    "data": {
        "note": "The latest MANTRA on-chain governance proposals (most recent first) — each proposal's id, title, status and voting window. Pass limit (1-50, default 10).",
        "count": 10,
        "source": "MANTRA (mantra-1) LCD",
        "proposals": [
            {
                "title": "v8.2.0 MAINNET MANTRA Chain Upgrade",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "33",
                "submit_time": "2026-06-02T07:40:24.528525867Z",
                "voting_end_time": "2026-06-09T07:40:24.528525867Z"
            },
            {
                "title": "Register wmantraUSD ERC20 Denom Pair (Expedited)",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "32",
                "submit_time": "2026-05-07T10:05:21.379573700Z",
                "voting_end_time": "2026-05-08T10:32:03.675584912Z"
            },
            {
                "title": "v8.1.1 MAINNET MANTRA Chain Upgrade (Expedited)",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "31",
                "submit_time": "2026-05-01T10:49:23.844835010Z",
                "voting_end_time": "2026-05-02T12:07:47.930579099Z"
            },
            {
                "title": "v8.0.0 MAINNET MANTRA Chain Upgrade",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "30",
                "submit_time": "2026-04-22T03:50:32.628630549Z",
                "vot
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of OM (the native token of MANTRA), in both OM and the amantra base denomination (18 decimals). No parameters.",
        "denom": "OM",
        "source": "MANTRA (mantra-1) LCD",
        "decimals": 18,
        "base_denom": "amantra",
        "total_supply_om": 7837754905.61,
        "total_supply_amantra": "7837754905606016097673094298"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:26.313Z",
        "request_id": "a4152be2-a871-48d8-a237-87611319fb04"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Economics

#### `GET /v1/inflation` — Monetary inflation & mint parameters

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

**Response:**
```json
{
    "data": {
        "note": "The MANTRA monetary inflation — the current annual inflation rate, the OM minted per year (annual provisions), and the mint parameters (blocks per year, target bonded ratio, inflation band). No parameters.",
        "params": {
            "mint_denom": "amantra",
            "blocks_per_year": 9562910,
            "goal_bonded_percent": 67,
            "inflation_max_percent": 16,
            "inflation_min_percent": 16
        },
        "source": "MANTRA (mantra-1) LCD",
        "annual_provisions_om": 1254040763.92,
        "annual_inflation_percent": 16
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:26.457Z",
        "request_id": "822634f7-f6bd-4cc2-90ab-028749a3ed40"
    },
    "status": "ok",
    "message": "Inflation retrieved successfully",
    "success": true
}
```

### Chain

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

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

**Response:**
```json
{
    "data": {
        "note": "The latest finalized MANTRA block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:21.306512230Z",
        "height": 15709154,
        "source": "MANTRA (mantra-1) LCD",
        "num_txs": 0,
        "chain_id": "mantra-1",
        "proposer_address": "O8T5CslxIA8OZfeduRl8DDzp6OM="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:26.608Z",
        "request_id": "e3f6329f-7bfd-4d60-a559-59388c48327c"
    },
    "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/mantra-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "latest_height": 15709154
        },
        "source": "MANTRA public Cosmos REST / LCD nodes (mantra-api.polkachu.com and mirrors), keyless",
        "service": "mantra-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/supply": "Total OM supply.",
            "GET /v1/staking": "Staking economics & parameters.",
            "GET /v1/inflation": "Monetary inflation & mint parameters.",
            "GET /v1/governance": "Latest governance proposals (limit).",
            "GET /v1/validators": "Active validator set (limit)."
        },
        "description": "Live on-chain data for MANTRA Chain (the real-world-asset (RWA) tokenization L1, chain mantra-1) with no key: staking economics (bonded vs unbonded OM, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total OM supply, monetary inflation (annual rate, annual provisions, mint parameters), the latest governance proposals, and the latest block. The MANTRA-on-chain / staking / inflation / governance layer for explorers, staking dashboards and research. Distinct from other chain readers — the MANTRA (mantra-1) RWA network. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:26.722Z",
        "request_id": "7ced2975-da94-403c-9b9b-1175d012cb2b"
    },
    "status": "
…(truncated, see openapi.json for full schema)
```


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