# XION Network API
> Live on-chain data for XION (chain-id xion-mainnet-1), a Cosmos-SDK Layer 1 built around a generalized abstraction layer with native account abstraction and stablecoin-denominated gas. Read the current chain status — latest block height, block time and chain id — list the active validator set with each validator moniker, staked XION, commission, delegator shares and jailed status, inspect the staking pool with bonded and not-bonded amounts and the bonded ratio, read the total XION supply, and browse the latest on-chain governance proposals with their status and voting windows. All XION amounts are returned both in base units (uxion) and as whole XION. Distinct from other Cosmos-chain APIs on the marketplace: this surfaces the XION mainnet specifically.

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

## Pricing
- **Free** (Free) — 1,560 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 44,800 calls/Mo, 6 req/s
- **Pro** ($32/Mo) — 189,000 calls/Mo, 18 req/s
- **Scale** ($74/Mo) — 822,000 calls/Mo, 45 req/s

## Endpoints

### Chain

#### `GET /v1/status` — Chain status (latest block)

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

**Response:**
```json
{
    "data": {
        "height": 21846165,
        "symbol": "XION",
        "num_txs": 0,
        "chain_id": "xion-mainnet-1",
        "decimals": 6,
        "block_time": "2026-06-15T11:15:09.425121661Z",
        "native_denom": "uxion",
        "proposer_address": "BcM08x0NkZIdC2bojHRQm9hmXLE="
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:19.776Z",
        "request_id": "93158efa-1a56-44f8-bce0-c334cee722cd"
    },
    "status": "ok",
    "message": "Status retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/staking-pool` — Bonded / not-bonded staking pool

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

**Response:**
```json
{
    "data": {
        "bonded_xion": 59142222.30861,
        "bonded_ratio": 0.967015,
        "bonded_uxion": "59142222308610",
        "not_bonded_xion": 2017353.472019,
        "not_bonded_uxion": "2017353472019"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:20.155Z",
        "request_id": "3df13416-6b07-43c9-bd7f-70a4fc43a189"
    },
    "status": "ok",
    "message": "Staking pool retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Validator set

**Parameters:**
- `status` (query, optional, string) — Bond status filter Example: `BOND_STATUS_BONDED`

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

**Response:**
```json
{
    "data": {
        "count": 32,
        "status": "BOND_STATUS_BONDED",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "Institutional-grade staking services and Web3 infrastructure provider. T&Cs apply, visit our website.",
                "moniker": "Stakin by The Tie",
                "website": "https://stakin.com",
                "xion_tokens": 6415810.883777,
                "commission_rate": 0.05,
                "delegator_shares": 6415810883777,
                "operator_address": "xionvaloper1pxk78p2hents9935a5ust8xy39c5xgpkcsz0r9"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "Trusted security provider for projects building on Cosmos and CosmWasm. We combine security research with a realistic approach to whether minimise risks and increase security awareness.",
                "moniker": "SCV-Security",
                "website": "www.scv.services",
                "xion_tokens": 5895461.1508,
                "commission_rate": 0.05,
                "delegator_shares": 5895461150800,
                "operator_address": "xionvaloper1tsch433esuruhwzee3ya8ea3q3vr4hukqaqktz"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "Hex Trust is a fully licensed digital asset custodian dedicated to 
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "denom": "uxion",
        "symbol": "XION",
        "decimals": 6,
        "total_xion": 210287847.177993,
        "total_uxion": "210287847177993"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:21.101Z",
        "request_id": "8ae5e606-5646-44b4-8d91-4d03af3168b6"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Governance

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

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

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

**Response:**
```json
{
    "data": {
        "count": 10,
        "proposals": [
            {
                "id": 58,
                "title": "Software Upgrade v30",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "Software Upgrade v30",
                "submit_time": "2026-06-09T23:24:26.737902983Z",
                "voting_end_time": "2026-06-13T23:24:26.737902983Z"
            },
            {
                "id": 57,
                "title": "Software Upgrade v29",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "Software Upgrade v29",
                "submit_time": "2026-04-17T14:01:38.298747539Z",
                "voting_end_time": "2026-04-21T14:01:38.298747539Z"
            },
            {
                "id": 56,
                "title": "Store TradeOS Contract Code",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "### Link to discourse post\nhttps://discourse.xion.burnt.com/t/deploy-tradeos-cosmwasm-claim-contract-on-xion/110\n\n## Developer Information\n\n### Link to Developer/Company\nhttps://github.com/burnt-labs/\n\n### Developer Description\n## App Description\n\nThis proposal requests storing the TradeOS CosmWasm smart contract (tradeos-cw-sc) bytecode on XION mainnet. The contract is on-chain infrastructure bui",
                "submit_time": "2026-03-24T14:02:16.584234510Z",
                "voting_end_time": "2026-03-28T14:02:16.584234510Z"
            },
            {
        
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "name": "XION Network API",
        "source": "XION public LCD/REST (api.xion-mainnet-1.burnt.com)",
        "endpoints": [
            {
                "path": "/v1/status",
                "description": "Latest block height, time and chain id"
            },
            {
                "path": "/v1/validators",
                "description": "Validator set (?status=BOND_STATUS_BONDED)"
            },
            {
                "path": "/v1/staking-pool",
                "description": "Bonded / not-bonded staking pool and bonded ratio"
            },
            {
                "path": "/v1/supply",
                "description": "Total XION supply"
            },
            {
                "path": "/v1/governance",
                "description": "Latest governance proposals (?limit=10)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public XION LCD. Not affiliated with XION / Burnt Labs. Data only; no guarantees of accuracy or availability.",
        "description": "On-chain data for XION (chain-id xion-mainnet-1), a Cosmos-SDK Layer 1 with a generalized abstraction layer and native account abstraction. Exposes chain status, the validator set, the staking pool, total XION supply and governance proposals.",
        "native_token": {
            "denom": "uxion",
            "symbol": "XION",
   
…(truncated, see openapi.json for full schema)
```


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