# Persistence On-Chain API
> Live on-chain data for Persistence (the liquid-staking & RWA Cosmos L1 behind pSTAKE, chain core-1) with no key: staking economics (bonded vs unbonded XPRT, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total XPRT supply, monetary inflation (annual rate, annual provisions, mint parameters), the latest governance proposals, 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/persistence-api/..."
```

## Pricing
- **Free** (Free) — 6,700 calls/Mo, 2 req/s
- **Basic** ($35/Mo) — 169,000 calls/Mo, 10 req/s
- **Pro** ($94/Mo) — 970,000 calls/Mo, 20 req/s
- **Scale** ($167/Mo) — 5,310,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/persistence-api/v1/staking"
```

**Response:**
```json
{
    "data": {
        "note": "The Persistence staking economics — bonded vs unbonded XPRT, the bonded ratio, and the chain's staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "uxprt",
            "max_validators": 100,
            "min_commission_rate": 0.05,
            "unbonding_time_seconds": 1814400
        },
        "source": "Persistence (core-1) LCD",
        "bonded_xprt": 139288427.12,
        "not_bonded_xprt": 8984812.91,
        "bonded_ratio_percent": 93.94
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:23.857Z",
        "request_id": "7c5261a9-a49d-4a31-8724-8fc4386da4d5"
    },
    "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/persistence-api/v1/validators?limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "The active Persistence validator set, ranked by voting power — each validator's moniker, website, voting power (in XPRT), commission rate and status. Pass limit (1-100, default 25).",
        "count": 25,
        "source": "Persistence (core-1) LCD",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "GPooL.io",
                "website": "https://GPooL.io",
                "commission_rate": 0.05,
                "operator_address": "persistencevaloper13frxdtypzz722wy3ylzlmh8tqcyje8lhzchtqp",
                "voting_power_xprt": 15725108.42
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Cosmostation",
                "website": "https://www.cosmostation.io",
                "commission_rate": 0.05,
                "operator_address": "persistencevaloper1rq598kexpsdmhxq63qq74v3tf22u6yvlre4r00",
                "voting_power_xprt": 14520415.67
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Staking4All",
                "website": "https://www.staking4all.org",
                "commission_rate": 0.05,
                "operator_address": "persistencevaloper1tzn8rk09ez2gm55sffpyzt7ccn5yzshpql8rug",
                "voting_power_xprt": 8539973.82
            },
            {
…(truncated, see openapi.json for full schema)
```

### Governance

#### `GET /v1/governance` — Latest governance proposals

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

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

**Response:**
```json
{
    "data": {
        "note": "The latest Persistence on-chain governance proposals (most recent first) — each proposal's id, title, status and voting window. Pass limit (1-50, default 10).",
        "count": 10,
        "source": "Persistence (core-1) LCD",
        "proposals": [
            {
                "title": "PersistenceCore v16.0.0",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "154",
                "submit_time": "2025-11-18T14:26:00.874240990Z",
                "voting_end_time": "2025-11-23T14:39:28.216585812Z"
            },
            {
                "title": "Recover expired ibc client on Injective",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "153",
                "submit_time": "2025-10-27T15:56:12.023912790Z",
                "voting_end_time": "2025-11-01T16:17:49.346791396Z"
            },
            {
                "title": "Recover expired ibc client on Injective",
                "status": "PROPOSAL_STATUS_FAILED",
                "proposal_id": "152",
                "submit_time": "2025-10-27T06:05:53.102416760Z",
                "voting_end_time": "2025-11-01T13:19:10.872464073Z"
            },
            {
                "title": "Incentivization of Persistence DEX pools with stkXPRT rewards for November 2025",
                "status": "PROPOSAL_STATUS_PASSED",
                "proposal_id": "151",
                "submit_time": "2025-10-25T13:46:54.163039
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of XPRT (the native token of Persistence), in both XPRT and the uxprt micro-denomination. No parameters.",
        "denom": "XPRT",
        "source": "Persistence (core-1) LCD",
        "micro_denom": "uxprt",
        "total_supply_xprt": 261481683.34,
        "total_supply_uxprt": "261481683339988"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:24.312Z",
        "request_id": "4c13868e-7d0e-48e3-b7c7-99fb37b6802d"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Economics

#### `GET /v1/inflation` — Monetary inflation & mint parameters

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

**Response:**
```json
{
    "data": {
        "note": "The Persistence monetary inflation — the current annual inflation rate, the XPRT minted per year (annual provisions), and the mint parameters (blocks per year, target bonded ratio, inflation band). No parameters.",
        "params": {
            "mint_denom": "uxprt",
            "blocks_per_year": 5259600,
            "goal_bonded_percent": 67,
            "inflation_max_percent": 12.5,
            "inflation_min_percent": 6.25
        },
        "source": "Persistence (core-1) LCD",
        "annual_provisions_xprt": 32685209.64,
        "annual_inflation_percent": 12.5
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:24.456Z",
        "request_id": "c1e25fb5-c4ae-4e28-a4d1-601abe7e3819"
    },
    "status": "ok",
    "message": "Inflation retrieved successfully",
    "success": true
}
```

### Chain

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

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

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Persistence block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:16.095356191Z",
        "height": 27842147,
        "source": "Persistence (core-1) LCD",
        "num_txs": 0,
        "chain_id": "core-1",
        "proposer_address": "oWolchODHgRW5OX8CxtTIvVpHTc="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:24.613Z",
        "request_id": "22c8433e-f744-478d-aee0-003c038b9f8f"
    },
    "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/persistence-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "latest_height": 27842147
        },
        "source": "Persistence public Cosmos REST / LCD nodes (persistence-api.polkachu.com and mirrors), keyless",
        "service": "persistence-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/supply": "Total XPRT supply.",
            "GET /v1/staking": "Staking economics & parameters.",
            "GET /v1/inflation": "Monetary inflation & mint parameters.",
            "GET /v1/governance": "Latest governance proposals (limit).",
            "GET /v1/validators": "Active validator set (limit)."
        },
        "description": "Live on-chain data for Persistence (the liquid-staking & RWA Cosmos L1 behind pSTAKE, chain core-1) with no key: staking economics (bonded vs unbonded XPRT, bonded ratio, staking parameters), the active validator set (moniker, voting power, commission, status), the total XPRT supply, monetary inflation (annual rate, annual provisions, mint parameters), the latest governance proposals, and the latest block. The Persistence-on-chain / staking / inflation / governance layer for explorers, staking dashboards and research. Distinct from other chain readers — the Persistence (core-1) network. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:24.769Z",
        "request_id": "a902c8b9-5bbc-4262-86ec-bc681664
…(truncated, see openapi.json for full schema)
```


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