# Sui Validators API
> Read the live Sui validator set and staking economics from a public Sui fullnode JSON-RPC — no key. Sui is delegated proof-of-stake; this surfaces what account- and coin-readers miss: the active validators ranked by stake, each with its commission rate, live APY, voting power and staking-pool balance; any single validator's full profile (rewards pool, gas price, metadata); and the current epoch's system state — total stake, validator count, reference gas price, storage fund and epoch timing. The staking-and-validator layer every Sui wallet, staking dashboard, delegator and analytics tool needs to decide where to stake and how the network is secured. Live from the chain; short cache only.

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

## Pricing
- **Free** (Free) — 5,700 calls/Mo, 3 req/s
- **Starter** ($11/Mo) — 118,500 calls/Mo, 8 req/s
- **Pro** ($37/Mo) — 738,000 calls/Mo, 20 req/s
- **Business** ($106/Mo) — 4,660,000 calls/Mo, 50 req/s

## Endpoints

### Staking

#### `GET /v1/system` — Current epoch system state

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

**Response:**
```json
{
    "data": {
        "note": "The current Sui epoch's system state: total stake, validator count, reference gas price, storage fund and epoch timing.",
        "epoch": "1158",
        "source": "Sui fullnode JSON-RPC",
        "epoch_start_ms": 1781395521723,
        "total_stake_sui": 7227128568.64594,
        "protocol_version": "124",
        "active_validators": 129,
        "epoch_duration_ms": 86400000,
        "reference_gas_price": 100,
        "system_state_version": "2",
        "storage_fund_total_sui": 1447745.1506632,
        "pending_active_validators": 0,
        "stake_subsidy_current_epoch_sui": 313810.59609
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:54.254Z",
        "request_id": "f5f99b21-c7de-4793-8753-2153bbf66840"
    },
    "status": "ok",
    "message": "System state retrieved successfully",
    "success": true
}
```

#### `GET /v1/validator` — Full profile of one validator

**Parameters:**
- `address` (query, required, string) — Sui validator address (0x...) Example: `0x8f8ea04f3b751533db8b8da0a40eba1ca8332a92680f058d83b9459d061aaa54`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/suivalidators-api/v1/validator?address=0x8f8ea04f3b751533db8b8da0a40eba1ca8332a92680f058d83b9459d061aaa54"
```

**Response:**
```json
{
    "data": {
        "name": "InfStones",
        "note": "Full profile of an active Sui validator: stake, commission, live APY, voting power, rewards pool and metadata.",
        "source": "Sui fullnode JSON-RPC",
        "address": "0x8f8ea04f3b751533db8b8da0a40eba1ca8332a92680f058d83b9459d061aaa54",
        "apy_pct": 1.394411304503446,
        "gas_price": 910,
        "image_url": "https://github.com/sili-infstones/infstones-logo/raw/main/infstones_logo.webp",
        "stake_sui": 10027225.423489949,
        "description": "InfStones runs an enterprise-grade node management and staking platform",
        "project_url": "https://infstones.com",
        "voting_power": 13,
        "network_address": "/dns/prod.sui.infstones.io/tcp/8080/http",
        "rewards_pool_sui": 651699.391322932,
        "pending_stake_sui": 0,
        "pool_token_balance": "9198269036213693",
        "commission_rate_pct": 8,
        "next_epoch_stake_sui": 10027228.303032076
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:54.461Z",
        "request_id": "4efe8c46-105d-48ea-b545-c9ea2e4ae052"
    },
    "status": "ok",
    "message": "Validator retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Active validators ranked by stake or apy

**Parameters:**
- `limit` (query, optional, string) — How many (1-200) Example: `30`
- `sort` (query, optional, string) — Sort: stake or apy Example: `stake`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/suivalidators-api/v1/validators?limit=30&sort=stake"
```

**Response:**
```json
{
    "data": {
        "note": "Active Sui validators ranked by stake (or apy). stake_sui is the staking-pool balance; commission and apy are percentages; voting_power is in basis points of total.",
        "sort": "stake",
        "count": 30,
        "epoch": "1158",
        "source": "Sui fullnode JSON-RPC",
        "validators": [
            {
                "name": "Mysten-1",
                "address": "0x4fffd0005522be4bc029724c7f0f6ed7093a6bf3a09b90e62f61dc15181e1a3e",
                "apy_pct": 1.5675840273569563,
                "gas_price": 100,
                "stake_sui": 218815560.51009005,
                "project_url": "https://mystenlabs.com/",
                "voting_power": 303,
                "commission_rate_pct": 2,
                "next_epoch_stake_sui": 218837476.80338868
            },
            {
                "name": "Mysten-2",
                "address": "0xcb7efe4253a0fe58df608d8a2d3c0eea94b4b40a8738c8daae4eb77830c16cd7",
                "apy_pct": 1.5693865481818614,
                "gas_price": 100,
                "stake_sui": 182164788.07928687,
                "project_url": "https://mystenlabs.com/",
                "voting_power": 253,
                "commission_rate_pct": 2,
                "next_epoch_stake_sui": 182186191.07928687
            },
            {
                "name": "Coinbase",
                "address": "0x0350925241ae8d4083fe4b1104e14dd28d2ffeced9d7575551c50c41b99995fb",
                "apy_pct": 1.4373355835
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata & live sample

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

**Response:**
```json
{
    "data": {
        "sample": {
            "epoch": "1158",
            "validators": 129
        },
        "source": "public Sui fullnode JSON-RPC (suix_getLatestSuiSystemState / suix_getValidatorsApy), keyless",
        "service": "suivalidators-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/system": "Current epoch system state: total stake, validators, gas price, storage fund.",
            "GET /v1/validator": "Full profile of one validator (address=0x...).",
            "GET /v1/validators": "Active validators ranked by stake or apy (limit, sort=stake|apy)."
        },
        "description": "Read the live Sui validator set and staking economics from a public Sui fullnode JSON-RPC: active validators ranked by stake with commission/APY/voting-power, any single validator's profile, and the current epoch's system state. The staking-and-validator layer for Sui wallets, staking dashboards and delegators. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:54.621Z",
        "request_id": "c4b22ca0-a47b-44e5-be72-f79dafbe85f2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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