# Neutron On-Chain API
> Live on-chain data for Neutron (the Cosmos integrated DeFi L1, chain neutron-1) with no key: staking economics (bonded vs unbonded NTRN, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total NTRN supply, the on-chain community pool (treasury) holdings, and the latest block.

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

## Pricing
- **Free** (Free) — 11,200 calls/Mo, 2 req/s
- **Basic** ($20/Mo) — 251,000 calls/Mo, 10 req/s
- **Pro** ($54/Mo) — 1,370,000 calls/Mo, 20 req/s
- **Scale** ($125/Mo) — 7,280,000 calls/Mo, 50 req/s

## Endpoints

### Staking

#### `GET /v1/staking` — Staking economics & parameters

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

**Response:**
```json
{
    "data": {
        "note": "The Neutron staking economics — bonded vs unbonded NTRN, the bonded ratio, and the chain's staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "untrn",
            "max_validators": 18,
            "min_commission_rate": 0,
            "unbonding_time_seconds": 1728000
        },
        "source": "Neutron (neutron-1) LCD",
        "bonded_ntrn": 158806962.56,
        "not_bonded_ntrn": 37175846.35,
        "bonded_ratio_percent": 81.03
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:39.606Z",
        "request_id": "969790c7-dbae-457a-85c1-88714f96815a"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Active validator set ranked by voting power

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

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

**Response:**
```json
{
    "data": {
        "note": "The active Neutron validator set, ranked by voting power — each validator's moniker, website, voting power (in NTRN), commission rate and status. Pass limit (1-100, default 25).",
        "count": 15,
        "source": "Neutron (neutron-1) LCD",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Cosmostation",
                "website": "https://www.cosmostation.io",
                "commission_rate": 0.1,
                "operator_address": "neutronvaloper1ap2gshzfwglun4y2gpz6meugggat42s7vndhsw",
                "voting_power_ntrn": 15414815.89,
                "max_commission_rate": 0.1
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "01node",
                "website": "https://01node.com",
                "commission_rate": 0.04,
                "operator_address": "neutronvaloper1rlyy2ltkc9t9s8gp2tmqxk6guggf6h9g6xj26y",
                "voting_power_ntrn": 13513635.08,
                "max_commission_rate": 0.2
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "polkachu.com",
                "website": "https://polkachu.com",
                "commission_rate": 0.1,
                "operator_address": "neutronvaloper1xvl6sq77k6eq8kg9pyjyt8dzxzpyv9ukuuvsay",
             
…(truncated, see openapi.json for full schema)
```

### Supply

#### `GET /v1/supply` — Total NTRN supply

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of NTRN (the native token of Neutron), in both NTRN and the untrn micro-denomination. No parameters.",
        "denom": "NTRN",
        "source": "Neutron (neutron-1) LCD",
        "micro_denom": "untrn",
        "total_supply_ntrn": 631518333.07,
        "total_supply_untrn": "631518333068960"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:39.835Z",
        "request_id": "ca07da30-1ce1-4137-a614-ef4d92c3ac64"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Treasury

#### `GET /v1/community-pool` — On-chain community pool (treasury)

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

**Response:**
```json
{
    "data": {
        "note": "The Neutron on-chain community pool (treasury) — the native NTRN balance, the number of distinct assets held, and the ten largest holdings. No parameters.",
        "source": "Neutron (neutron-1) LCD",
        "top_assets": [
            {
                "denom": "untrn",
                "amount": 1068.5015
            },
            {
                "denom": "factory/neutron1ffus553eet978k024lmssw0czsxwr97mggyv85lpcsdkft8v9ufsz3sa07/astro",
                "amount": 342.0133
            },
            {
                "denom": "ibc/4A6A46D4263F2ED3DCE9CF866FE15E6903FB5E12D87EB8BDC1B6B1A1E2D397B4",
                "amount": 253.6473
            },
            {
                "denom": "ibc/B559A80D62249C8AA07A380E2A2BEA6E5CA9A6F079C912C3A9E9B494105E4F81",
                "amount": 233.8632
            },
            {
                "denom": "ibc/C4CFF46FD6DE35CA4CF4CE031E643C8FDC9BA4B99AE598E9B0ED98FE3A2319F9",
                "amount": 187.5751
            },
            {
                "denom": "ibc/F082B65C88E4B6D5EF1DB243CDA1D331D002759E938A0F5CD3FFDC5D53B3E349",
                "amount": 83.1979
            },
            {
                "denom": "ibc/A585C2D15DCD3B010849B453A2CFCB5E213208A5AB665691792684C26274304D",
                "amount": 36.6006
            },
            {
                "denom": "ibc/773B4D0A3CD667B2275D5A4A7A2F0909C0BA0F4059C0B9181E680DDF4965DCC7",
                "amount": 33.2443
            },
    
…(truncated, see openapi.json for full schema)
```

### Chain

#### `GET /v1/block` — Latest block

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

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Neutron block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:38.255894664Z",
        "round": 0,
        "height": 59133940,
        "source": "Neutron (neutron-1) LCD",
        "num_txs": 1,
        "chain_id": "neutron-1",
        "proposer_address": "1m69+M7H0/UimjKNkINCcffKDBw="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:40.085Z",
        "request_id": "ceef216a-bac5-422f-9c27-424e670d2573"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata & endpoint catalog

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

**Response:**
```json
{
    "data": {
        "sample": {
            "latest_height": 59133940
        },
        "source": "Neutron public Cosmos REST / LCD nodes (neutron-api.polkachu.com and mirrors), keyless",
        "service": "neutron-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/supply": "Total NTRN supply.",
            "GET /v1/staking": "Staking economics & parameters.",
            "GET /v1/validators": "Active validator set (limit).",
            "GET /v1/community-pool": "On-chain community pool (treasury)."
        },
        "description": "Live on-chain data for Neutron (the Cosmos integrated DeFi L1, chain neutron-1) with no key: staking economics (bonded vs unbonded NTRN, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total NTRN supply, the on-chain community pool (treasury) holdings, and the latest block. The Neutron-on-chain / staking / treasury layer for explorers, staking dashboards and research. Distinct from other chain readers — the Neutron (neutron-1) network. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:40.186Z",
        "request_id": "a40fe9f0-6dab-434b-b8cd-49228e63ff49"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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