# Archway Developer-Rewards On-Chain API
> Live on-chain data from Archway (archway-1), the Cosmos-SDK layer-1 whose x/rewards module pays smart-contract developers a share of inflation and transaction fees. Read the dApp rewards pool (undistributed and treasury funds in ARCH); the current block's inflation and transaction rewards tracking; the rewards parameters (inflation-rewards ratio, tx-fee rebate ratio, minimum gas price); plus the staking pool with bonded ratio and validator set, the total ARCH supply and the latest block. The Archway / contract-rewards / developer-economy layer for explorers, dApp dashboards and reward trackers.

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

## Pricing
- **Free** (Free) — 2,900 calls/Mo, 2 req/s
- **Basic** ($15/Mo) — 67,000 calls/Mo, 5 req/s
- **Pro** ($44/Mo) — 255,000 calls/Mo, 15 req/s
- **Business** ($93/Mo) — 955,000 calls/Mo, 40 req/s

## Endpoints

### Rewards

#### `GET /v1/block-rewards` — Current block inflation & tx rewards

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "denom": "ARCH",
        "height": 15937456,
        "max_gas": 300000000,
        "tx_rewards_count": 0,
        "inflation_rewards": 1.1132691186975525
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:52.756Z",
        "request_id": "9f121cdc-67f3-4308-87dd-4edd1b306603"
    },
    "status": "ok",
    "message": "Block rewards retrieved successfully",
    "success": true
}
```

#### `GET /v1/rewards-params` — x/rewards parameters

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "min_price_of_gas": {
            "denom": "aarch",
            "amount": 140000000000
        },
        "tx_fee_rebate_ratio": 0.5,
        "max_withdraw_records": 25000,
        "inflation_rewards_ratio": 0.25
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:52.877Z",
        "request_id": "3b94cc76-6dbf-403d-9acf-934aff3ee8e3"
    },
    "status": "ok",
    "message": "Rewards params retrieved successfully",
    "success": true
}
```

#### `GET /v1/rewards-pool` — dApp rewards pool (undistributed & treasury)

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "denom": "ARCH",
        "treasury_funds": 43347218.17818487,
        "undistributed_funds": 82648.79583073745
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:52.999Z",
        "request_id": "0eb96794-53a1-4573-956f-18d9a1ea1d39"
    },
    "status": "ok",
    "message": "Rewards pool retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/staking` — Staking pool, bonded ratio & params

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "denom": "ARCH",
        "params": {
            "bond_denom": "aarch",
            "max_validators": 40,
            "unbonding_time": "1814400s",
            "min_commission_rate": "0.000000000000000000"
        },
        "bonded_ratio": 0.608398,
        "bonded_tokens": 307690104.5900728,
        "not_bonded_tokens": 198048389.25080934
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:53.164Z",
        "request_id": "6d595b91-c82e-4f33-8e0c-9aa273f26eaa"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

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

**Parameters:**
- `limit` (query, optional, string) — Number of validators (1-200) Example: `20`

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "count": 20,
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "DELIGHT",
                "website": null,
                "voting_power": 39548775.04081592,
                "commission_rate": 0.05,
                "operator_address": "archwayvaloper1qsw3w58yaca87v0g86eqsec0rjxegzjd75gvt4"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Astrovault",
                "website": null,
                "voting_power": 35770339.91261777,
                "commission_rate": 0.08,
                "operator_address": "archwayvaloper1ra4y9k2lle29ztcztcf7chvr7ayjr7uvrj9lam"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Alphabet",
                "website": "https://alphab.ai/s/m/archway/",
                "voting_power": 18387838.181496657,
                "commission_rate": 0.05,
                "operator_address": "archwayvaloper16vh6jdzrvda47stsjlxap6yukh5pq4q06sgcm6"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "CroutonDigital",
                "website": "https://crouton.digital",
                "voting_power": 16007767.588643247,
                "commission_rate": 
…(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/archway-api/v1/block"
```

**Response:**
```json
{
    "data": {
        "time": "2026-06-15T02:09:44.439041110Z",
        "chain": "archway-1",
        "height": 15937456,
        "num_txs": 0,
        "proposer_address": "C4VDOb3MFLhfuHEeQcKUI3dHb3A="
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:53.409Z",
        "request_id": "e27431ba-630c-4188-8a60-dc6d046479c5"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "denom": "ARCH",
        "micro_denom": "aarch",
        "total_supply": 1171070055.793406,
        "total_supply_atto": "1171070055793405887105304097"
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:53.540Z",
        "request_id": "51d0f7fb-0371-4791-8492-cb46ef8b2449"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Chain metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "chain": "archway-1",
        "token": "ARCH",
        "source": "Archway public Cosmos REST/LCD, keyless (3-mirror)",
        "network": "Archway",
        "decimals": 18,
        "examples": {
            "validators": "/v1/validators?limit=20",
            "rewards_pool": "/v1/rewards-pool",
            "rewards_params": "/v1/rewards-params"
        },
        "endpoints": {
            "/v1/block": "latest block (height, time, chain_id)",
            "/v1/supply": "total ARCH supply",
            "/v1/staking": "staking pool, bonded ratio and params",
            "/v1/validators": "bonded validator set ranked by voting power (limit)",
            "/v1/rewards-pool": "dApp rewards pool — undistributed & treasury funds (ARCH)",
            "/v1/block-rewards": "current block inflation & tx rewards tracking",
            "/v1/rewards-params": "x/rewards params (inflation-rewards ratio, tx-fee rebate ratio, min gas price)"
        },
        "micro_denom": "aarch",
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:53.594Z",
        "request_id": "43901f20-ed69-4919-9713-9bfaac0a2fb2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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