# Saga On-Chain API
> Live on-chain data for Saga (the chainlet-launchpad L1 that lets projects spin up app-specific chains, chain ssc-1) with no key: staking economics (bonded vs unbonded SAGA, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total SAGA 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/saga-api/..."
```

## Pricing
- **Free** (Free) — 7,100 calls/Mo, 2 req/s
- **Basic** ($32/Mo) — 177,000 calls/Mo, 10 req/s
- **Pro** ($89/Mo) — 1,010,000 calls/Mo, 20 req/s
- **Scale** ($163/Mo) — 5,520,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/saga-api/v1/staking"
```

**Response:**
```json
{
    "data": {
        "note": "The Saga staking economics — bonded vs unbonded SAGA, the bonded ratio, and the chain's staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "usaga",
            "max_validators": 21,
            "min_commission_rate": 0,
            "unbonding_time_seconds": 1814400
        },
        "source": "Saga (ssc-1) LCD",
        "bonded_saga": 55405722.35,
        "not_bonded_saga": 18352409.73,
        "bonded_ratio_percent": 75.12
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:27.792Z",
        "request_id": "385811d4-a9a5-4697-8a6d-0b5166228bc2"
    },
    "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/saga-api/v1/validators?limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "The active Saga validator set, ranked by voting power — each validator's moniker, website, voting power (in SAGA), commission rate and status. Pass limit (1-100, default 25).",
        "count": 19,
        "source": "Saga (ssc-1) LCD",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Cosmostation",
                "website": "https://www.cosmostation.io",
                "commission_rate": 0.015,
                "operator_address": "sagavaloper1nv7mzp90rjxkgrr7ymcfqufgjeqtr7ptfeflz8",
                "voting_power_saga": 10999996.33
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Omnistake.com",
                "website": "https://omnistake.com",
                "commission_rate": 0,
                "operator_address": "sagavaloper1am6qxsfxpzxdk7j8e8s37vs6pe8zr6m922nqte",
                "voting_power_saga": 10223017.85
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "NodeStake",
                "website": "https://nodestake.org",
                "commission_rate": 0.0249,
                "operator_address": "sagavaloper19f0w9svr905fhefusyx4z8sf83j6et0gsn0qkm",
                "voting_power_saga": 7173184.04
            },
            {
                "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/saga-api/v1/governance?limit=10"
```

**Response:**
```json
{
    "data": {
        "note": "The latest Saga 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": "Saga (ssc-1) LCD",
        "proposals": [
            {
                "title": "Upgrade SSC to v4",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "28",
                "submit_time": "2026-03-16T21:56:05.754184968Z",
                "voting_end_time": "2026-03-17T21:56:05.754184968Z"
            },
            {
                "title": "add Saga Logo New Crypto Game",
                "status": "PROPOSAL_STATUS_REJECTED",
                "proposal_id": "27",
                "submit_time": "2026-03-12T22:00:42.582374911Z",
                "voting_end_time": "2026-03-19T22:00:42.582374911Z"
            },
            {
                "title": "Upgrade SSC to v4",
                "status": "PROPOSAL_STATUS_FAILED",
                "proposal_id": "26",
                "submit_time": "2026-03-09T22:20:26.918499310Z",
                "voting_end_time": "2026-03-16T22:20:26.918499310Z"
            },
            {
                "title": "Upgrade to v3",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "25",
                "submit_time": "2025-12-23T00:21:04.476452818Z",
                "voting_end_time": "2025-12-24T00:33:45.309349403Z"
            },
            {
                "
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of SAGA (the native token of Saga), in both SAGA and the usaga micro-denomination. No parameters.",
        "denom": "SAGA",
        "source": "Saga (ssc-1) LCD",
        "micro_denom": "usaga",
        "total_supply_saga": 1101698405.47,
        "total_supply_usaga": "1101698405468811"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:28.164Z",
        "request_id": "f341f70a-68e8-44dd-93d2-a9707be0ffa9"
    },
    "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/saga-api/v1/inflation"
```

**Response:**
```json
{
    "data": {
        "note": "The Saga monetary inflation — the current annual inflation rate, the SAGA minted per year (annual provisions), and the mint parameters (blocks per year, target bonded ratio, inflation band). No parameters.",
        "params": {
            "mint_denom": "usaga",
            "blocks_per_year": 5484522,
            "goal_bonded_percent": 67,
            "inflation_max_percent": 3,
            "inflation_min_percent": 3
        },
        "source": "Saga (ssc-1) LCD",
        "annual_provisions_saga": 33050951.98,
        "annual_inflation_percent": 3
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:28.272Z",
        "request_id": "c7ad04fc-7167-4f04-9913-be6bc384ec98"
    },
    "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/saga-api/v1/block"
```

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Saga block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:19.818726586Z",
        "height": 12205809,
        "source": "Saga (ssc-1) LCD",
        "num_txs": 0,
        "chain_id": "ssc-1",
        "proposer_address": "ajJDG7bzJPqOsBWZTNgVPDoPOjo="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:28.383Z",
        "request_id": "644e5217-6d41-439a-8128-ee36930a99f7"
    },
    "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/saga-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "latest_height": 12205809
        },
        "source": "Saga public Cosmos REST / LCD nodes (saga-api.polkachu.com and mirrors), keyless",
        "service": "saga-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/supply": "Total SAGA 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 Saga (the chainlet-launchpad L1 that lets projects spin up app-specific chains, chain ssc-1) with no key: staking economics (bonded vs unbonded SAGA, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total SAGA supply, monetary inflation (annual rate, annual provisions, mint parameters), the latest governance proposals, and the latest block. The Saga-on-chain / staking / inflation / governance layer for explorers, staking dashboards and research. Distinct from other chain readers — the Saga (ssc-1) network. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:28.521Z",
        "request_id": "28841410-b34f-437c-9020-43a87c91646a"
    },
    "st
…(truncated, see openapi.json for full schema)
```


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