# Osmosis DEX On-Chain API
> Live on-chain data for Osmosis (the leading Cosmos DEX / AMM L1, chain osmosis-1) with no key: the DEX liquidity pools (GAMM AMM pools with their assets, reserves, swap fee and total count), a single pool full detail, the Osmosis chain staking economics, the total OSMO supply, and the latest block.

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

## Pricing
- **Free** (Free) — 8,100 calls/Mo, 2 req/s
- **Basic** ($30/Mo) — 197,000 calls/Mo, 10 req/s
- **Pro** ($85/Mo) — 1,120,000 calls/Mo, 20 req/s
- **Scale** ($154/Mo) — 6,110,000 calls/Mo, 50 req/s

## Endpoints

### DEX

#### `GET /v1/pool` — Single liquidity pool full detail

**Parameters:**
- `id` (query, required, string) — Numeric pool id Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/osmosischain-api/v1/pool?id=1"
```

**Response:**
```json
{
    "data": {
        "note": "Full detail for a single Osmosis liquidity pool — its assets with on-chain reserves, weights, swap/exit fee and total shares. Pass id (the numeric pool id, e.g. 1).",
        "pool": {
            "id": "1",
            "type": "Pool",
            "assets": [
                {
                    "denom": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2",
                    "amount": "236184699856",
                    "weight": "536870912000000"
                },
                {
                    "denom": "uosmo",
                    "amount": "10011061539026",
                    "weight": "536870912000000"
                }
            ],
            "exit_fee": 0,
            "swap_fee": 0.002,
            "total_shares": "35489126249509848615403363"
        },
        "source": "Osmosis (osmosis-1) LCD"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:32.815Z",
        "request_id": "dbd2a01f-5e64-49d5-97ef-35b271141f28"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

#### `GET /v1/pools` — DEX liquidity pools + chain-wide pool count

**Parameters:**
- `limit` (query, optional, string) — Results 1-100 Example: `20`

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

**Response:**
```json
{
    "data": {
        "note": "The Osmosis DEX liquidity pools (GAMM automated-market-maker pools) — each pool's id, type, swap/exit fee, total shares and its assets with on-chain reserves. Pass limit (1-100, default 20). total_pools is the chain-wide pool count.",
        "count": 20,
        "pools": [
            {
                "id": "1",
                "type": "Pool",
                "assets": [
                    {
                        "denom": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2",
                        "amount": "236184699856",
                        "weight": "536870912000000"
                    },
                    {
                        "denom": "uosmo",
                        "amount": "10011061539026",
                        "weight": "536870912000000"
                    }
                ],
                "exit_fee": 0,
                "swap_fee": 0.002,
                "total_shares": "35489126249509848615403363"
            },
            {
                "id": "2",
                "type": "Pool",
                "assets": [
                    {
                        "denom": "uion",
                        "amount": "311380830",
                        "weight": "858993459200000"
                    },
                    {
                        "denom": "uosmo",
                        "amount": "38526471770",
                        "weight": "214748364800000"
                    }
             
…(truncated, see openapi.json for full schema)
```

### Staking

#### `GET /v1/staking` — Osmosis chain staking economics & parameters

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

**Response:**
```json
{
    "data": {
        "note": "The Osmosis chain staking economics — bonded vs unbonded OSMO, the bonded ratio, and the staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "uosmo",
            "max_validators": 70,
            "min_commission_rate": 0.05,
            "unbonding_time_seconds": 1209600
        },
        "source": "Osmosis (osmosis-1) LCD",
        "bonded_osmo": 201693822.06,
        "not_bonded_osmo": 44419512.31,
        "bonded_ratio_percent": 81.95
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:33.097Z",
        "request_id": "f7676961-49a1-4d62-9758-69875c5441eb"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

### Supply

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

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of OSMO (the native token of Osmosis), in both OSMO and the uosmo micro-denomination. No parameters.",
        "denom": "OSMO",
        "source": "Osmosis (osmosis-1) LCD",
        "micro_denom": "uosmo",
        "total_supply_osmo": 777488140.8,
        "total_supply_uosmo": "777488140801773"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:33.199Z",
        "request_id": "7431e19f-46a3-4362-ad3e-2dcb93796bfd"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Chain

#### `GET /v1/block` — Latest block

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

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Osmosis block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:31.047218980Z",
        "height": 64098084,
        "source": "Osmosis (osmosis-1) LCD",
        "num_txs": 1,
        "chain_id": "osmosis-1",
        "proposer_address": "xx7zwESZhHO0zsyumXcZdvGY1KU="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:33.324Z",
        "request_id": "5172a146-dce6-4fe5-98ac-f086e9189222"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata & endpoint catalog

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

**Response:**
```json
{
    "data": {
        "sample": {
            "total_pools": 3469
        },
        "source": "Osmosis public Cosmos REST / LCD nodes (osmosis-api.polkachu.com and mirrors), keyless",
        "service": "osmosischain-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "Single pool full detail (id).",
            "GET /v1/block": "Latest block.",
            "GET /v1/pools": "DEX liquidity pools (limit) + chain-wide pool count.",
            "GET /v1/supply": "Total OSMO supply.",
            "GET /v1/staking": "Osmosis chain staking economics & parameters."
        },
        "description": "Live on-chain data for Osmosis (the leading Cosmos DEX / AMM L1, chain osmosis-1) with no key: the DEX liquidity pools (GAMM AMM pools with their assets, reserves, swap fee and total count), a single pool's full detail, the Osmosis chain staking economics, the total OSMO supply, and the latest block. The Osmosis-DEX / on-chain / staking layer for DeFi dashboards, liquidity analytics and research. Distinct from other chain readers — Osmosis and its AMM liquidity pools. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:33.448Z",
        "request_id": "d353c419-ff1a-4a3e-9191-3ef72e7d40b2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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