# Radix Validators & Network API
> The Radix Network validator set and ledger status — Radix's proof-of-stake — live from the official public Radix Gateway API, no key, nothing cached. Radix is a layer-1 built for DeFi with its own asset-oriented ledger; its network is secured by validators who stake XRD and accept delegations. This is the first Radix reader in the marketplace. Rank the validators by staked XRD, each with its name, total stake, share of network stake, fee factor and whether it is in the current active set. Look up a single validator by its component address for its stake, rank, share and fee. And read the live ledger status — the current epoch and round, the ledger state version, the validator count and the total XRD staked across the network. The validator-and-staking layer for Radix wallets, staking dashboards, delegators and analytics. Live from mainnet.radixdlt.com.

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

## Pricing
- **Free** (Free) — 7,250 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 138,500 calls/Mo, 9 req/s
- **Pro** ($34/Mo) — 803,000 calls/Mo, 22 req/s
- **Business** ($92/Mo) — 4,920,000 calls/Mo, 55 req/s

## Endpoints

### Validators

#### `GET /v1/validator` — One validator by address: stake, rank, share, fee

**Parameters:**
- `address` (query, optional, string) — Radix validator address (omit for the top validator)

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

**Response:**
```json
{
    "data": {
        "name": "REDDICKS NODE",
        "note": "A single Radix validator by component address: its name, staked XRD, rank, share of network stake, fee factor and active state. Omit address for the top validator.",
        "rank": 1,
        "active": true,
        "source": "Radix Gateway",
        "address": "validator_rdx1swywqhv3ed5w6dldfs2vamtrsyrdsfd6l9cqen5xqe54597gyckpns",
        "fee_pct": 100,
        "stake_pct": 4.8352,
        "stake_xrd": 230066823.97542426
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:33.513Z",
        "request_id": "d6c098b3-2529-4be8-82d7-e07f5946f5ea"
    },
    "status": "ok",
    "message": "Validator retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Validators ranked by staked XRD, with name, share, fee, active state

**Parameters:**
- `limit` (query, optional, string) — Max validators (1-300) Example: `30`

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

**Response:**
```json
{
    "data": {
        "note": "Radix Network validators ranked by staked XRD (own plus delegated). stake_pct is the validator's share of total network stake; fee_pct is the commission it charges; active marks validators in the current epoch's active set.",
        "count": 30,
        "source": "Radix Gateway",
        "validators": [
            {
                "name": "REDDICKS NODE",
                "rank": 1,
                "active": true,
                "address": "validator_rdx1swywqhv3ed5w6dldfs2vamtrsyrdsfd6l9cqen5xqe54597gyckpns",
                "fee_pct": 100,
                "stake_pct": 4.8352,
                "stake_xrd": 230066823.97542426
            },
            {
                "name": "SRWA",
                "rank": 2,
                "active": true,
                "address": "validator_rdx1sdvntpsfvlyx2hapn5zfr6z7etfwgqljsqdqh23876r33fpd8cvu5j",
                "fee_pct": 0,
                "stake_pct": 4.7511,
                "stake_xrd": 226068446.55942872
            },
            {
                "name": "Astrolescent",
                "rank": 3,
                "active": true,
                "address": "validator_rdx1sw54cuswwzlcgw2zh3ax93pddnsm78qwwhmtvz650q84yyckzkh7nk",
                "fee_pct": 15,
                "stake_pct": 4.2424,
                "stake_xrd": 201861115.968999
            },
            {
                "name": "WEFT",
                "rank": 4,
                "active": true,
                "address": "validato
…(truncated, see openapi.json for full schema)
```

### Network

#### `GET /v1/network` — Live ledger status: epoch, round, state version, validators, total XRD staked

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

**Response:**
```json
{
    "data": {
        "note": "Live Radix ledger status: the current epoch and round, the ledger state version, plus the validator count and total XRD staked across the network.",
        "epoch": 317382,
        "round": 29,
        "source": "Radix Gateway",
        "network": "mainnet",
        "state_version": 522453547,
        "total_stake_xrd": 4758207911.86,
        "validator_count": 287,
        "ledger_timestamp": "2026-06-14T17:04:29.025Z",
        "active_validators": 100
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:33.712Z",
        "request_id": "d518f14c-f2e4-4961-a2ec-d0b3d4193063"
    },
    "status": "ok",
    "message": "Network retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "epoch": 317382,
            "validators": 287,
            "total_stake_xrd": 4758207911.86
        },
        "source": "official public Radix Gateway API (mainnet.radixdlt.com), keyless",
        "service": "radixvalidators-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/network": "Live ledger status: epoch, round, state version, validators, total XRD staked.",
            "GET /v1/validator": "One validator by address: stake, rank, share, fee (address; omit for top).",
            "GET /v1/validators": "Validators ranked by staked XRD, with name, share, fee, active state (limit)."
        },
        "description": "Read the Radix Network validator set and ledger status live from the official public Radix Gateway: rank validators by staked XRD with their name, share of network stake, fee and active state; look up a single validator by address; and read the live ledger status (epoch, round, state version, validator count, total XRD staked). The validator-and-staking layer for Radix wallets, staking dashboards and delegators. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:33.803Z",
        "request_id": "d015216d-0f3f-4b36-b334-e440b0224ba4"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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