# Oraichain API
> Live on-chain data for Oraichain — the AI-oracle Layer-1 built on the Cosmos SDK, whose native token is ORAI — served directly from public LCD/REST nodes with multi-node failover. The status endpoint returns the latest block height and time, chain id, the staking bond denom and the current minting inflation rate. The validators endpoint lists the active bonded validator set ranked by stake, each with its moniker, operator address, self-plus-delegated ORAI tokens, commission rate and jailed flag. The supply endpoint returns the total ORAI supply, the amount bonded in staking and the resulting bonded ratio. The governance endpoint returns the most recent on-chain proposals with their id, title, status and voting window. Token amounts are converted from base micro-ORAI (6 decimals) into whole ORAI, and all figures are read live from the chain — nothing is bundled or modelled — with a short server-side cache and keep-warm so the feed stays fast and fresh. Ideal for staking dashboards, validator and delegator tooling, explorers, governance trackers and portfolio or analytics apps covering the Cosmos and AI-blockchain ecosystem. Live keyless upstream. 5 endpoints.

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

## Pricing
- **Free** (Free) — 300 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 16,800 calls/Mo, 8 req/s
- **Pro** ($37/Mo) — 78,000 calls/Mo, 16 req/s
- **Mega** ($92/Mo) — 315,000 calls/Mo, 40 req/s

## Endpoints

### Oraichain

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

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

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

**Response:**
```json
{
    "data": {
        "chain": "Oraichain",
        "count": 15,
        "symbol": "ORAI",
        "proposals": [
            {
                "id": "323",
                "title": "Execute Burn of 500,000 ORAI",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2026-01-26T04:37:24.667313418Z",
                "voting_end_time": "2026-01-31T04:37:24.667313418Z"
            },
            {
                "id": "322",
                "title": "Execute Transfer for Oraichain Mainnet Block Reward Continuation",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-01-25T03:58:01.079199412Z",
                "voting_end_time": "2026-01-26T03:58:01.079199412Z"
            },
            {
                "id": "321",
                "title": "Upgrade Oraichain to v0.50.13",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-01-16T03:21:05.896704127Z",
                "voting_end_time": "2026-01-17T03:21:05.896704127Z"
            },
            {
                "id": "320",
                "title": "Execute Fund Allocation for Oraichain Quant Terminal",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2025-12-17T03:57:08.066912477Z",
                "voting_end_time": "2025-12-18T03:57:08.066912477Z"
            },
            {
                "id": "319",
                "title": "ORAI Tokenomics 2026 – Governance Proposal",
     
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/status` — Chain status

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

**Response:**
```json
{
    "data": {
        "chain": "Oraichain",
        "source": "Oraichain LCD",
        "symbol": "ORAI",
        "chain_id": "Oraichain",
        "bond_denom": "orai",
        "inflation_pct": 7,
        "latest_block_time": "2026-06-15T20:39:39.534932576Z",
        "latest_block_height": 111052170
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:28.682Z",
        "request_id": "bce2818b-4fc6-4c31-84e2-7bed4f23c33e"
    },
    "status": "ok",
    "message": "Oraichain status retrieved",
    "success": true
}
```

#### `GET /v1/supply` — ORAI supply & bonded ratio

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

**Response:**
```json
{
    "data": {
        "chain": "Oraichain",
        "denom": "orai",
        "bonded": 6643911.569184,
        "symbol": "ORAI",
        "decimals": 6,
        "total_supply": 15828316.932676,
        "bonded_ratio_pct": 41.97
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:28.760Z",
        "request_id": "74ef05e2-15b0-4b90-ad28-0d5b68e6d71e"
    },
    "status": "ok",
    "message": "Oraichain supply retrieved",
    "success": true
}
```

#### `GET /v1/validators` — Active validator set

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

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

**Response:**
```json
{
    "data": {
        "chain": "Oraichain",
        "count": 41,
        "symbol": "ORAI",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 832740.881314,
                "moniker": "OWALLET",
                "commission_pct": 3,
                "operator_address": "oraivaloper1q53ujvvrcd0t543dsh5445lu6ar0qr2zv4yhhp"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 672272.417575,
                "moniker": "Synergy Nodes",
                "commission_pct": 3,
                "operator_address": "oraivaloper1xesqr8vjvy34jhu027zd70ypl0nnev5euy9nyl"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 541612.255141,
                "moniker": "ORAI_Vanguard",
                "commission_pct": 3,
                "operator_address": "oraivaloper1uhcwtfntsvk8gpwfxltesyl4e28aalmq9v9z0x"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 538148.721625,
                "moniker": "Blockval",
                "commission_pct": 3,
                "operator_address": "oraivaloper1f6q9wjn8qp3ll8y8ztd8290vtec2yxyxxygyy2"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
               
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "api": "Oraichain API",
        "chain": "Oraichain",
        "denom": "orai",
        "source": "Oraichain public LCD/REST nodes (Cosmos SDK)",
        "symbol": "ORAI",
        "decimals": 6,
        "endpoints": [
            "/v1/status",
            "/v1/validators",
            "/v1/supply",
            "/v1/governance",
            "/v1/meta"
        ],
        "description": "Live on-chain data for Oraichain — the AI-oracle Layer-1 Cosmos-SDK blockchain (ORAI).",
        "documentation": "https://oraichain-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:28.924Z",
        "request_id": "28206ec9-89a8-4295-9f43-3dfdc8bc1081"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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