# Solana Network Status API
> The live performance and monetary health of the Solana blockchain, read straight from public Solana RPC nodes, no key. Solana is one of the highest-throughput blockchains in crypto, and its network state — how fast it is processing transactions right now, where it is in the current staking epoch, how much SOL exists and how fast new SOL is being minted — is the heartbeat that traders, validators and builders watch. The status endpoint is the live dashboard: the current epoch and how far through it the chain is (with an estimate of the time left until the next epoch), the absolute slot and block height, the lifetime transaction count, the current transactions-per-second, the average slot time and the node health. The supply endpoint returns the SOL money supply — total, circulating and non-circulating — with the circulating share and the live inflation rate broken into its validator and foundation parts. The performance endpoint returns the recent throughput samples — transactions, slots and TPS over the last few one-minute windows — so you can see whether the chain is speeding up or slowing down. This is the Solana network performance / monetary cut, distinct from the Solana validators feed (which ranks validators by stake and measures decentralisation), and from the price, DeFi and on-chain-token feeds. SOL amounts are in whole SOL (converted from lamports); rates are percentages; everything is live. Built for crypto dashboards, trading and infrastructure-monitoring tools.

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

## Pricing
- **Free** (Free) — 1,130 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 24,200 calls/Mo, 6 req/s
- **Pro** ($33/Mo) — 127,000 calls/Mo, 16 req/s
- **Mega** ($75/Mo) — 694,000 calls/Mo, 40 req/s

## Endpoints

### Status

#### `GET /v1/status` — Live Solana network dashboard

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

**Response:**
```json
{
    "data": {
        "note": "Live Solana network dashboard: the current staking epoch and how far through it the chain is (epoch_progress_pct), with an estimate of the hours left until the next epoch, the current slot and block height, the lifetime transaction count, the current transactions-per-second, the average slot time, and the RPC node health. Live, cached ~30s.",
        "epoch": 986,
        "health": "ok",
        "source": "Public Solana JSON-RPC (getEpochInfo, getRecentPerformanceSamples, getHealth), keyless",
        "slot_index": 93765,
        "current_tps": 3497,
        "block_height": 404125899,
        "absolute_slot": 426045765,
        "slots_in_epoch": 432000,
        "slots_remaining": 338235,
        "avg_slot_time_ms": 405,
        "epoch_progress_pct": 21.7,
        "lifetime_transaction_count": 520179670517,
        "est_time_to_next_epoch_hours": 38.1
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:00.240Z",
        "request_id": "711cf4c6-69cd-4ad2-9c6e-f266e1bbaa97"
    },
    "status": "ok",
    "message": "Status retrieved successfully",
    "success": true
}
```

### Supply

#### `GET /v1/supply` — SOL money supply and inflation rate

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

**Response:**
```json
{
    "data": {
        "note": "The SOL money supply — total, circulating and non-circulating (locked/reserved), with the circulating share — and the live network inflation rate split into the validator and foundation parts. Solana mints new SOL each epoch as staking rewards; the inflation rate decays over time toward a long-run floor. SOL amounts converted from lamports. Live, cached ~30s.",
        "source": "Public Solana JSON-RPC (getSupply, getInflationRate), keyless",
        "inflation": {
            "epoch": 986,
            "total_pct": 3.8,
            "validator_pct": 3.8,
            "foundation_pct": 0
        },
        "total_sol": 628304450,
        "circulating_pct": 92.3,
        "circulating_sol": 579824610,
        "non_circulating_sol": 48479840
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:08.674Z",
        "request_id": "329eb853-5bb2-4db0-a8d1-39b2e4e002ee"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Performance

#### `GET /v1/performance` — Recent throughput samples (TPS)

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

**Response:**
```json
{
    "data": {
        "note": "Recent Solana throughput — for each of the last few one-minute windows: the number of transactions and slots produced, the resulting transactions-per-second and the average slot time. Read the trend to see whether the chain is speeding up or congesting. Live, cached ~30s.",
        "source": "Public Solana JSON-RPC (getRecentPerformanceSamples), keyless",
        "samples": [
            {
                "tps": 3497,
                "slots": 148,
                "period_secs": 60,
                "slot_time_ms": 405,
                "transactions": 209815
            },
            {
                "tps": 3391,
                "slots": 152,
                "period_secs": 60,
                "slot_time_ms": 395,
                "transactions": 203477
            },
            {
                "tps": 3350,
                "slots": 155,
                "period_secs": 60,
                "slot_time_ms": 387,
                "transactions": 200988
            }
        ],
        "current_tps": 3497
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:08.836Z",
        "request_id": "2f0a286b-8f7a-482d-a34e-9772a9397571"
    },
    "status": "ok",
    "message": "Performance retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "status, supply, performance and meta take no parameters. SOL amounts are whole SOL (converted from lamports); inflation and progress are percentages; TPS is transactions per second from the latest one-minute sample. A short ~30-second protective cache fronts the RPC upstream, with a public-node fallback.",
        "sample": {
            "epoch": 986,
            "block_height": 404125922
        },
        "source": "Public Solana JSON-RPC (api.mainnet-beta.solana.com with public-node fallback), keyless, live",
        "service": "solananetwork-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/status": "Live network dashboard — epoch, progress, slot, TPS, health.",
            "GET /v1/supply": "SOL money supply (total/circulating/non-circulating) and inflation rate.",
            "GET /v1/performance": "Recent throughput samples (transactions, slots, TPS)."
        },
        "description": "Live Solana network performance and monetary health, straight from public Solana RPC nodes (no key). It exposes the live network dashboard (current epoch and progress, slot and block height, lifetime transactions, current TPS, slot time, health), the SOL money supply (total/circulating/non-circulating + the live inflation rate), and the recent throughput samples. The network performance / monetary cut — distinct from the Solana validators feed (which ranks validators by stake and measures decentralisation
…(truncated, see openapi.json for full schema)
```


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