# Elys Network API
> Live on-chain data for Elys Network (chain-id elys-1), a Cosmos-SDK DeFi Layer 1 built around an on-chain AMM, perpetual futures and leveraged liquidity provision, with the ELYS token. Read the current chain status — latest block height, block time and chain id — list the active validator set with each validator moniker, staked ELYS, commission and jailed status, inspect the staking pool with bonded and not-bonded amounts and the bonded ratio, read the total ELYS supply, and explore the full multi-asset on-chain supply — the bank module holds ELYS alongside dozens of bridged IBC assets and AMM liquidity-pool shares — plus the latest on-chain governance proposals with their status and voting windows. All ELYS amounts are returned both in base units (uelys) and as whole ELYS. Distinct from other Cosmos-chain APIs on the marketplace: this surfaces the Elys Network DeFi chain 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/elys-api/..."
```

## Pricing
- **Free** (Free) — 1,720 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 49,200 calls/Mo, 6 req/s
- **Pro** ($31/Mo) — 196,000 calls/Mo, 18 req/s
- **Scale** ($70/Mo) — 798,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/elys-api/v1/status"
```

**Response:**
```json
{
    "data": {
        "height": 12929744,
        "symbol": "ELYS",
        "num_txs": 1,
        "chain_id": "elys-1",
        "decimals": 6,
        "block_time": "2026-06-15T11:15:03.725686690Z",
        "native_denom": "uelys",
        "proposer_address": "VABl/HJY2OXcBpkJs3T5LBvkI8U="
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:15.725Z",
        "request_id": "617af8f1-02df-4f21-963b-e5b2b2d17df8"
    },
    "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/elys-api/v1/staking-pool"
```

**Response:**
```json
{
    "data": {
        "bonded_elys": 9746436.27381,
        "bonded_ratio": 0.787777,
        "bonded_uelys": "9746436273810",
        "not_bonded_elys": 2625636.799779,
        "not_bonded_uelys": "2625636799779"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:15.885Z",
        "request_id": "bf505aef-74ee-4791-98c5-cb508ed20c15"
    },
    "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/elys-api/v1/validators?status=BOND_STATUS_BONDED"
```

**Response:**
```json
{
    "data": {
        "count": 92,
        "status": "BOND_STATUS_BONDED",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "Team OtterSync",
                "moniker": "OtterSync",
                "website": "https://ottersync.io",
                "elys_tokens": 1011801.269777,
                "commission_rate": 0.05,
                "operator_address": "elysvaloper1d4z902aezhpq7aph9rfrjax0awmtq4dqcxujdu"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "kwak kwak",
                "moniker": "kwak",
                "website": "https://kwak.io",
                "elys_tokens": 1005501.17308,
                "commission_rate": 0.05,
                "operator_address": "elysvaloper1jlp368vpqgwugdy2sezw2mlglga3qsxcwkdhdl"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "details": "We are the gatekeepers of Elys.  We are the direct voice of the community, and we only vote for what the community wants",
                "moniker": "Elys Keepers",
                "website": "NONE",
                "elys_tokens": 929131.902694,
                "commission_rate": 0.05,
                "operator_address": "elysvaloper197uts40mlzwvcsz7smhhnl2khwdgt67tn70zt0"
            },
            {
                "jailed": false,
       
…(truncated, see openapi.json for full schema)
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "denom": "uelys",
        "symbol": "ELYS",
        "decimals": 6,
        "total_elys": 155866617.998211,
        "total_uelys": "155866617998211"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:16.228Z",
        "request_id": "f2204a35-224a-4b5f-87f8-a97be93aea3f"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Assets

#### `GET /v1/assets` — Full multi-asset on-chain supply

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

**Response:**
```json
{
    "data": {
        "assets": [
            {
                "denom": "amm/pool/4",
                "label": "AMM LP share",
                "amount": "46985530384307831067033"
            },
            {
                "denom": "ibc/8464A63954C0350A26C8588E20719F3A0AC8705E4CA0F7450B60C3F16B2D3421",
                "label": "IBC asset",
                "amount": "6955539034646993768414"
            },
            {
                "denom": "ibc/421AE2B1D80E42890BF227DBC56C3CADEDA050F21AD1B5DDC1EBE9B9737A4DC6",
                "label": "IBC asset",
                "amount": "1968186033822987047850"
            },
            {
                "denom": "amm/pool/6",
                "label": "AMM LP share",
                "amount": "690530079708096019463"
            },
            {
                "denom": "ibc/ADF401C952ADD9EE232D52C8303B8BE17FE7953C8D420F20769AF77240BD0C58",
                "label": "IBC asset",
                "amount": "125761707493516266582"
            },
            {
                "denom": "amm/pool/13",
                "label": "AMM LP share",
                "amount": "109562138634132780071"
            },
            {
                "denom": "amm/pool/2",
                "label": "AMM LP share",
                "amount": "1852444766459499021"
            },
            {
                "denom": "amm/pool/18",
                "label": "AMM LP share",
                "amount": "688204066888227024"
            },
            {
            
…(truncated, see openapi.json for full schema)
```

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

**Response:**
```json
{
    "data": {
        "count": 10,
        "proposals": [
            {
                "id": 102,
                "title": "v6.11.0 Upgrade",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "This proposal is the final upgrade before chain halt. Through this proposal we are trying squeeze out as much value as possible of ibc assets which are stuck on the chain. ",
                "submit_time": "2026-06-08T18:04:19.127742910Z",
                "voting_end_time": "2026-06-10T18:04:19.127742910Z"
            },
            {
                "id": 101,
                "title": "Recover IBC light client for XRPL EVM Network",
                "status": "PROPOSAL_STATUS_PASSED",
                "summary": "This proposal updates the expired IBC light client `07-tendermint-57` for counterparty chain `xrplevm_1440000-1` with the state of the substitute client `07-tendermint-62`",
                "submit_time": "2026-05-21T09:00:16.739108944Z",
                "voting_end_time": "2026-05-23T09:00:16.739108944Z"
            },
            {
                "id": 100,
                "title": "Recover IBC light client for XRPL EVM Network",
                "status": "PROPOSAL_STATUS_REJECTED",
                "summary": "This proposal updates the expired IBC light client `07-tendermint-57` for counterparty chain `xrplevm_1440000-1` with the state of the substitute client `07-tendermint-61`",
                "submit_time": "2026-05-18T08:39:57.851796030Z",
…(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/elys-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "name": "Elys Network API",
        "source": "Elys Network public LCD/REST",
        "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 ELYS supply"
            },
            {
                "path": "/v1/assets",
                "description": "Full multi-asset on-chain supply (ELYS, IBC and LP denoms)"
            },
            {
                "path": "/v1/governance",
                "description": "Latest governance proposals (?limit=10)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public Elys Network LCD. Not affiliated with Elys Network. Data only; no guarantees of accuracy or availability.",
        "description": "On-chain data for Elys Network (chain-id elys-1), a Cosmos-SDK DeFi Layer 1 with an AMM, perpetuals and leveraged liquidity, native token ELYS. Exposes chain status, the validator set, the stakin
…(truncated, see openapi.json for full schema)
```


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