# Sifchain API
> Live on-chain data for Sifchain (chain id sifchain-1) — the Cosmos-SDK Layer-1 omni-chain decentralised exchange, whose native token is ROWAN — 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 ROWAN, commission rate and jailed flag. The supply endpoint returns the total ROWAN 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. ROWAN uses an 18-decimal base denomination which is converted to whole ROWAN with exact big-integer scaling, and every figure is read live from the chain — nothing bundled or modelled — behind a short server-side cache with 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 across the Cosmos and cross-chain DEX 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/sifchain-api/..."
```

## Pricing
- **Free** (Free) — 270 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 13,600 calls/Mo, 8 req/s
- **Pro** ($35/Mo) — 71,000 calls/Mo, 16 req/s
- **Mega** ($87/Mo) — 290,000 calls/Mo, 40 req/s

## Endpoints

### Sifchain

#### `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/sifchain-api/v1/governance?limit=15"
```

**Response:**
```json
{
    "data": {
        "chain": "Sifchain",
        "count": 15,
        "symbol": "ROWAN",
        "proposals": [
            {
                "id": "156",
                "title": "Revive Sentinelhub Client",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2025-01-24T16:43:21.492925570Z",
                "voting_end_time": "2025-01-26T16:43:21.492925570Z"
            },
            {
                "id": "155",
                "title": "Revive Juno Client",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2025-01-20T05:53:21.945708078Z",
                "voting_end_time": "2025-01-22T05:53:21.945708078Z"
            },
            {
                "id": "154",
                "title": "v1.4.1",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2024-05-21T19:24:27.015797570Z",
                "voting_end_time": "2024-05-23T19:24:27.015797570Z"
            },
            {
                "id": "153",
                "title": "Sifchain Evolution Proposal: Council Restructuring, New Roadmap, and Strategic Financial Utilization for Enhanced Ecosystem Growth",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2024-01-05T10:57:48.487630566Z",
                "voting_end_time": "2024-01-07T10:57:48.487630566Z"
            },
            {
                "id": "149",
                "title": "v1.4.0 (fix plan name)",
                "status
…(truncated, see openapi.json for full schema)
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "Sifchain",
        "source": "Sifchain LCD",
        "symbol": "ROWAN",
        "chain_id": "sifchain-1",
        "bond_denom": "rowan",
        "inflation_pct": 38.5,
        "latest_block_time": "2026-06-15T20:40:11.911700611Z",
        "latest_block_height": 28835680
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:23.432Z",
        "request_id": "d2c81109-04f6-4a04-a31e-3f3f501d4241"
    },
    "status": "ok",
    "message": "Sifchain status retrieved",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "Sifchain",
        "denom": "rowan",
        "bonded": 22225218580.01404,
        "symbol": "ROWAN",
        "decimals": 18,
        "total_supply": 52441014621.57428,
        "bonded_ratio_pct": 42.38
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:23.733Z",
        "request_id": "b3a4be32-ee6c-4726-86fb-0da4ffa285a0"
    },
    "status": "ok",
    "message": "Sifchain 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/sifchain-api/v1/validators?limit=100"
```

**Response:**
```json
{
    "data": {
        "chain": "Sifchain",
        "count": 21,
        "symbol": "ROWAN",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 1866256973.184378,
                "moniker": "AlxVoy ⚡ ANODE.TEAM",
                "commission_pct": 5,
                "operator_address": "sifvaloper1zxlzghpkpv9gmkyaaq8shrwhxmkzhdrelylm6w"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 1826467172.765071,
                "moniker": "Oldcat",
                "commission_pct": 5,
                "operator_address": "sifvaloper1gstrmcv3tqrskdj7uqu4x4tkh8nfw4qp9f85pm"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 1795907543.308497,
                "moniker": "256x25",
                "commission_pct": 5,
                "operator_address": "sifvaloper1hsxakzjzadrte27xkphdxpvdklelwzjcyr4rll"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 1794316603.981441,
                "moniker": "Stakewolle.com | Auto-compound",
                "commission_pct": 5,
                "operator_address": "sifvaloper1ecv3sdx8h54ckv8q8u67cyk0nj37rffwpj7cdx"
            },
            {
                "jailed": false,
                "status": "BO
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "api": "Sifchain API",
        "chain": "Sifchain",
        "denom": "rowan",
        "source": "Sifchain public LCD/REST nodes (Cosmos SDK)",
        "symbol": "ROWAN",
        "chain_id": "sifchain-1",
        "decimals": 18,
        "endpoints": [
            "/v1/status",
            "/v1/validators",
            "/v1/supply",
            "/v1/governance",
            "/v1/meta"
        ],
        "description": "Live on-chain data for Sifchain — the Cosmos-SDK Layer-1 omni-chain DEX (ROWAN).",
        "documentation": "https://sifchain-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:23.968Z",
        "request_id": "2b6b7e20-792f-441d-b10c-36a10201a41f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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