# Marinade API
> Live data from Marinade, Solana's largest liquid-staking protocol, where users stake SOL and hold mSOL (a reward-accruing token) or use Marinade Native. The overview endpoint returns the headline state — the mSOL/SOL price, the 30d and 7d staking APY, and the total value locked. The tvl endpoint returns the full TVL breakdown (staked SOL/USD, liquidity, directed, native, self and select stake). The apy endpoint returns the mSOL staking APY over 30d and 7d with the underlying price evolution. The validators endpoint returns Marinade's delegation validator set ranked by stake — each with its name, vote account, data-centre location, commission, activated stake, average APY and uptime. Read live from Marinade, nothing stored. This is Marinade's own Solana liquid-staking, mSOL-yield, TVL and validator layer — distinct from Ethereum staking feeds, on-chain explorers and DEX/price APIs.

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

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 80,000 calls/Mo, 15 req/s
- **Pro** ($24/Mo) — 400,000 calls/Mo, 45 req/s
- **Scale** ($54/Mo) — 2,500,000 calls/Mo, 130 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Headline state — mSOL price, APY, TVL

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

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "source": "Marinade",
        "protocol": "Marinade",
        "total_sol": 6630511.8246,
        "total_usd": 416172363.07,
        "apy_7d_pct": 6.9857,
        "staked_sol": 2566867.0513,
        "staked_usd": 161112619.16,
        "apy_30d_pct": 6.0234,
        "msol_price_sol": 1.38638691
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:27.773Z",
        "request_id": "b896482f-958c-4940-aefd-d348308f6257"
    },
    "status": "ok",
    "message": "Overview retrieved successfully",
    "success": true
}
```

### TVL

#### `GET /v1/tvl` — Full TVL breakdown

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

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "source": "Marinade",
        "total_sol": 6630511.8246,
        "total_usd": 416172363.07,
        "staked_sol": 2566867.0513,
        "staked_usd": 161112619.16,
        "liquidity_sol": 7531.5072,
        "liquidity_usd": 472724.46,
        "self_staked_sol": 1214034.7252,
        "self_staked_usd": 76200407.12,
        "standard_staked_sol": 1352832.3261,
        "msol_directed_stake_sol": 513373.4103,
        "total_virtual_staked_sol": 2536759.0896,
        "marinade_native_stake_sol": 2620686.4305,
        "marinade_native_stake_usd": 164490659.78,
        "marinade_select_stake_sol": 1149073.6273
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:28.314Z",
        "request_id": "d917f35d-192e-4299-8ea0-d5e88625feee"
    },
    "status": "ok",
    "message": "TVL retrieved successfully",
    "success": true
}
```

### APY

#### `GET /v1/apy` — mSOL staking APY over 30d and 7d

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

**Response:**
```json
{
    "data": {
        "apy": [
            {
                "window": "30d",
                "apy_pct": 6.0234,
                "end_time": "2026-06-10T22:54:47Z",
                "end_price": 1.38638691,
                "start_time": "2026-05-11T22:49:48Z",
                "start_price": 1.37973723
            },
            {
                "window": "7d",
                "apy_pct": 6.9857,
                "end_time": "2026-06-10T22:54:47Z",
                "end_price": 1.38638691,
                "start_time": "2026-06-03T22:49:48Z",
                "start_price": 1.3845918
            }
        ],
        "note": "mSOL accrues Solana staking rewards; its SOL value rises over time (no rebase).",
        "token": "mSOL",
        "source": "Marinade"
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:28.657Z",
        "request_id": "dafe41b3-121d-4215-9d1d-14fdc943b954"
    },
    "status": "ok",
    "message": "APY retrieved successfully",
    "success": true
}
```

### Validators

#### `GET /v1/validators` — Marinade validator set ranked by stake

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

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

**Response:**
```json
{
    "data": {
        "count": 25,
        "source": "Marinade",
        "validators": [
            {
                "url": "https://helius.dev",
                "city": "London",
                "name": "Helius",
                "country": "United Kingdom",
                "version": "4.0.0-rc.1",
                "identity": "HEL1USMZKAL2odpNBj2oCjffnFGaYwmbGmyewGv1e2TU",
                "avg_apy_pct": 5.4982,
                "vote_account": "he1iusunGwqrNtafDtLdhsUQDFvo13z9sUa36PauBtk",
                "superminority": true,
                "avg_uptime_pct": 100,
                "commission_pct": 0,
                "marinade_stake_sol": 0,
                "activated_stake_sol": 15273170.51
            },
            {
                "url": null,
                "city": "Toronto",
                "name": "Figment",
                "country": "Canada",
                "version": "4.0.0",
                "identity": "Fd7btgySsrjuo25CJCj7oE7VPMyezDhnx7pZkj2v69Nk",
                "avg_apy_pct": 5.1044,
                "vote_account": "CcaHc2L43ZWjwCHART3oZoJvHLAe9hzT2DJNUpBzoTN1",
                "superminority": true,
                "avg_uptime_pct": 100,
                "commission_pct": 7,
                "marinade_stake_sol": 0,
                "activated_stake_sol": 14805455.23
            },
            {
                "url": "https://www.binance.com",
                "city": "Ashburn",
                "name": "binance staking",
                "country": "United 
…(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/marinade-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Marinade API (api.marinade.finance + validators-api.marinade.finance, live)",
        "service": "marinade-api",
        "endpoints": {
            "GET /v1/apy": "mSOL staking APY over 30d and 7d with price evolution.",
            "GET /v1/tvl": "Full TVL breakdown (staked, liquidity, directed, native, self, select).",
            "GET /v1/meta": "This document.",
            "GET /v1/overview": "Headline state — mSOL/SOL price, 30d/7d APY, total value locked.",
            "GET /v1/validators": "Marinade's validator set ranked by stake (limit=25)."
        },
        "apy_30d_pct": 6.0234,
        "description": "Live data from Marinade, Solana's largest liquid-staking protocol, where users stake SOL and hold mSOL (a reward-accruing token) or use Marinade Native, via its public API. The overview endpoint returns the headline state — mSOL/SOL price, 30d and 7d staking APY, and total value locked; the tvl endpoint returns the full TVL breakdown (staked SOL/USD, liquidity, directed, native, self and select stake); the apy endpoint returns the mSOL staking APY over 30d and 7d with the underlying price evolution; the validators endpoint returns Marinade's validator set ranked by stake — name, vote account, location, commission, activated stake, average APY and uptime. Live, no key, nothing stored. Distinct from Ethereum staking feeds, on-chain explorers and DEX/price APIs — this is Marinade's own Solana liquid-staking, mSOL-yield, TVL 
…(truncated, see openapi.json for full schema)
```


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