# Sky (MakerDAO) Savings Rate & Protocol API
> Live protocol stats from Sky, the decentralized stablecoin protocol formerly known as MakerDAO and the issuer of the USDS and DAI stablecoins — no key, nothing stored. This is the Sky-protocol view: the Sky Savings Rate (SSR) and DAI Savings Rate (DSR), the value locked in savings, the SKY staking yield and the overall ecosystem size, distinct from the generic DeFi-TVL, yields and lending APIs in the catalogue. The overview endpoint returns the latest ecosystem snapshot — the Sky Savings Rate APY, the savings TVL, the SKY staking APY, the farm APY, the total reward TVL, the whole-ecosystem TVL, the wallet count and the number of savings depositors. The savings endpoint returns the current savings rates: the live SSR and DSR and the dollar value deposited in each. The history endpoint returns the savings-rate timeline — per-day SSR, DSR and deposited totals — so you can chart how the on-chain risk-free rate has moved. Build DeFi yield dashboards, stablecoin-savings widgets, rate-comparison tools and treasury bots on top of the dominant decentralized stablecoin protocol. SSR and DSR are the on-chain savings benchmarks for USDS and DAI; rates are returned as percentages.

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

## Pricing
- **Free** (Free) — 12,500 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 185,000 calls/Mo, 10 req/s
- **Pro** ($26/Mo) — 790,000 calls/Mo, 28 req/s
- **Scale** ($59/Mo) — 2,850,000 calls/Mo, 60 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Latest Sky ecosystem snapshot

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

**Response:**
```json
{
    "data": {
        "source": "BlockAnalitica (Sky)",
        "protocol": "Sky (MakerDAO)",
        "farm_apy_pct": 0,
        "wallet_count": 749842,
        "ecosystem_tvl_usd": 20862012856.14,
        "sky_staking_apy_pct": 5.7387,
        "ssr_depositor_count": 5707,
        "total_reward_tvl_usd": 624857282.8,
        "sky_savings_rate_apy_pct": 3.6,
        "sky_savings_rate_tvl_usd": 6118919137.29
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:32.040Z",
        "request_id": "66540bbc-36b8-423b-a843-e5eb3f44e5d9"
    },
    "status": "ok",
    "message": "Overview retrieved successfully",
    "success": true
}
```

### Savings

#### `GET /v1/savings` — Current SSR and DSR savings rates

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

**Response:**
```json
{
    "data": {
        "date": "2026-06-12",
        "source": "BlockAnalitica (Sky)",
        "protocol": "Sky (MakerDAO)",
        "dsr_rate_pct": 1.25,
        "ssr_rate_pct": 3.6,
        "total_in_dsr_usd": 219352958.17,
        "total_in_ssr_usd": 6118225057.44,
        "total_savings_usd": 6337578015.6
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:32.329Z",
        "request_id": "7ba7a5cf-7469-425b-a6b4-c21b86739d25"
    },
    "status": "ok",
    "message": "Savings retrieved successfully",
    "success": true
}
```

### History

#### `GET /v1/history` — Daily savings-rate timeline

**Parameters:**
- `limit` (query, optional, string) — Days back (default 30, max 365) Example: `30`

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

**Response:**
```json
{
    "data": {
        "count": 30,
        "source": "BlockAnalitica (Sky)",
        "history": [
            {
                "date": "2026-05-14",
                "dsr_rate_pct": 1.25,
                "ssr_rate_pct": 3.65,
                "total_in_dsr_usd": 239183821.88,
                "total_in_ssr_usd": 5650760410.47
            },
            {
                "date": "2026-05-15",
                "dsr_rate_pct": 1.25,
                "ssr_rate_pct": 3.65,
                "total_in_dsr_usd": 238611659.6,
                "total_in_ssr_usd": 5759470844.81
            },
            {
                "date": "2026-05-16",
                "dsr_rate_pct": 1.25,
                "ssr_rate_pct": 3.65,
                "total_in_dsr_usd": 238828658.09,
                "total_in_ssr_usd": 5759716930.1
            },
            {
                "date": "2026-05-17",
                "dsr_rate_pct": 1.25,
                "ssr_rate_pct": 3.65,
                "total_in_dsr_usd": 237441938.8,
                "total_in_ssr_usd": 5757793726.31
            },
            {
                "date": "2026-05-18",
                "dsr_rate_pct": 1.25,
                "ssr_rate_pct": 3.65,
                "total_in_dsr_usd": 236554151.23,
                "total_in_ssr_usd": 5942211436.72
            },
            {
                "date": "2026-05-19",
                "dsr_rate_pct": 1.25,
                "ssr_rate_pct": 3.65,
                "total_in_dsr_usd": 236277037.21,
          
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "SSR is the Sky Savings Rate (on USDS); DSR is the DAI Savings Rate. Rates are returned as percentages. The history endpoint returns the daily savings-rate series, oldest to newest.",
        "source": "BlockAnalitica Sky analytics (info-sky.blockanalitica.com/api/v1, live)",
        "service": "sky-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/history": "Daily savings-rate timeline (limit=30, max 365).",
            "GET /v1/savings": "Current savings rates — live SSR and DSR and the value deposited in each.",
            "GET /v1/overview": "Latest Sky ecosystem snapshot — SSR APY, savings TVL, SKY staking APY, ecosystem TVL, wallets."
        },
        "description": "Live protocol stats from Sky, the decentralized stablecoin protocol formerly known as MakerDAO (issuer of USDS/DAI). The Sky-protocol view — the Sky Savings Rate (SSR) and DAI Savings Rate (DSR), the value locked in savings, the SKY staking yield and the overall ecosystem size. overview = the latest ecosystem snapshot (Sky Savings Rate APY, savings TVL, SKY staking APY, farm APY, total reward TVL, ecosystem TVL, wallet count, savings depositor count); savings = the current savings rates (live SSR and DSR and the value deposited in each); history = the savings-rate timeline (per-day SSR, DSR and deposited totals). Live, no key, nothing stored. Distinct from the generic DeFi-TVL, yields and lending APIs.",
        "upstream
…(truncated, see openapi.json for full schema)
```


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