# Umee Cross-Chain Lending On-Chain API
> Live on-chain data from Umee (umee-1), the Cosmos-SDK layer-1 running the x/leverage cross-chain money market. Read every registered lending market with its oracle price, supply and borrow APY, supplied/borrowed/liquidity and uToken exchange rate; the full summary of a single market by denom; the leverage module risk parameters (liquidation thresholds and fees); the addresses currently flagged with bad debt; plus the staking pool with bonded ratio and validator set, the total UMEE supply and the latest block. The Umee / cross-chain-lending / money-market layer for DeFi dashboards, risk tools and yield 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/umee-api/..."
```

## Pricing
- **Free** (Free) — 2,800 calls/Mo, 2 req/s
- **Basic** ($15/Mo) — 64,000 calls/Mo, 5 req/s
- **Pro** ($43/Mo) — 250,000 calls/Mo, 15 req/s
- **Business** ($92/Mo) — 940,000 calls/Mo, 40 req/s

## Endpoints

### Lending

#### `GET /v1/bad-debts` — Addresses flagged with bad debt

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

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "count": 35,
        "bad_debts": [
            {
                "denom": "ibc/49788C29CD84E08D25CA7BE960BC1F61E88FEFC6333F58557D236D693398466A",
                "address": "umee1psa33w4j90nclax8yg3yp2nugk872rnadr63hh"
            },
            {
                "denom": "ibc/92BC8E5C50E6664B4DA748B62C1FFBE321967E1F8868EE03B005977F9AA7C0B8",
                "address": "umee1psa33w4j90nclax8yg3yp2nugk872rnadr63hh"
            },
            {
                "denom": "ibc/49788C29CD84E08D25CA7BE960BC1F61E88FEFC6333F58557D236D693398466A",
                "address": "umee1zr2snkpn68j4gt75d285u36fwkphhvt5f7adjv"
            },
            {
                "denom": "ibc/49788C29CD84E08D25CA7BE960BC1F61E88FEFC6333F58557D236D693398466A",
                "address": "umee1zfdyq7u6ze2yl74grrsa9tptfz344nktgymhyv"
            },
            {
                "denom": "ibc/92BC8E5C50E6664B4DA748B62C1FFBE321967E1F8868EE03B005977F9AA7C0B8",
                "address": "umee1zfdyq7u6ze2yl74grrsa9tptfz344nktgymhyv"
            },
            {
                "denom": "ibc/153B97FE395140EAAA2D7CAC537AF1804AEC5F0595CBC5F1603094018D158C0C",
                "address": "umee1rnze80lxzyg3em02fs9avstwq6yd2a52v7q2dx"
            },
            {
                "denom": "ibc/92BC8E5C50E6664B4DA748B62C1FFBE321967E1F8868EE03B005977F9AA7C0B8",
                "address": "umee1rnze80lxzyg3em02fs9avstwq6yd2a52v7q2dx"
            },
            {
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/market` — Full lending summary for one market

**Parameters:**
- `denom` (query, required, string) — Market denom (uumee or ibc/…) Example: `uumee`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/umee-api/v1/market?denom=uumee"
```

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "denom": "uumee",
        "market": {
            "symbol": "UMEE",
            "borrowed": 7092.949155,
            "exponent": 6,
            "reserved": 179062.676938,
            "supplied": 275154520.098508,
            "liquidity": 275147427.149354,
            "borrow_apy": 0.098978,
            "collateral": 182359511.302235,
            "supply_apy": 2.0e-6,
            "oracle_price": 8.22e-6,
            "available_borrow": 275147427.149353,
            "utoken_exchange_rate": 1.01040444,
            "oracle_historic_price": 8.24e-6
        }
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:13.263Z",
        "request_id": "d08c3c1a-ab70-4e7e-98be-f0ae64427c28"
    },
    "status": "ok",
    "message": "Market retrieved successfully",
    "success": true
}
```

#### `GET /v1/markets` — All registered lending markets

**Parameters:**
- `limit` (query, optional, string) — Number of markets (1-50) Example: `15`

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

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "count": 15,
        "markets": [
            {
                "denom": "uumee",
                "symbol": "UMEE",
                "borrowed": 7092.949155,
                "exponent": 6,
                "reserved": 179062.676938,
                "supplied": 275154520.098508,
                "liquidity": 275147427.149354,
                "borrow_apy": 0.098978,
                "collateral": 182359511.302235,
                "supply_apy": 2.0e-6,
                "oracle_price": 8.22e-6,
                "available_borrow": 275147427.149353,
                "utoken_exchange_rate": 1.01040444,
                "oracle_historic_price": 8.24e-6
            },
            {
                "denom": "ibc/04CE51E6E02243E565AE676DD60336E48D455F8AAD0611FA0299A22FDAC448D6",
                "symbol": "ETH",
                "borrowed": 0.000157800857503802,
                "exponent": 18,
                "reserved": 0.7146396689185494,
                "supplied": 4.4951080426321415,
                "liquidity": 4.494950241774638,
                "borrow_apy": 0.010003,
                "collateral": 3.9534648880593397,
                "supply_apy": 0,
                "oracle_price": 1719.41252098,
                "available_borrow": 4.494950241774638,
                "utoken_exchange_rate": 1.12484623,
                "oracle_historic_price": 1674.74315775
            },
            {
                "denom": "ibc/09C1ACBE292A5DF3DEC77B56DB4
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/params` — x/leverage risk parameters

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

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "params": {
            "rewards_auction_fee": 0.02,
            "minimum_close_factor": 0.05,
            "oracle_reward_factor": 0.01,
            "direct_liquidation_fee": 0.05,
            "small_liquidation_size": 500,
            "complete_liquidation_threshold": 0.4
        }
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:13.931Z",
        "request_id": "11862932-98b2-4534-8366-32ba9483a9c2"
    },
    "status": "ok",
    "message": "Params 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/umee-api/v1/staking"
```

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "denom": "UMEE",
        "params": {
            "bond_denom": "uumee",
            "max_validators": 100,
            "unbonding_time": "1209600s",
            "min_commission_rate": "0.050000000000000000"
        },
        "bonded_ratio": 0.62502,
        "bonded_tokens": 3524330605.359676,
        "not_bonded_tokens": 2114418666.006749
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:14.038Z",
        "request_id": "a44ed401-dba3-4aa4-add7-20d04e1dcacc"
    },
    "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/umee-api/v1/validators?limit=20"
```

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "count": 20,
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "MZONDER",
                "website": null,
                "voting_power": 477642316.194668,
                "commission_rate": 0.09,
                "operator_address": "umeevaloper1nlsvx2cl4wksknfx9dk7svn0rushylzj4g8l6z"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Alphabet",
                "website": "https://alphab.ai/s/m/umee/",
                "voting_power": 359403513.740813,
                "commission_rate": 0.1,
                "operator_address": "umeevaloper1qr97jr05ftqfnly7hegw4q03g3sctzwj34ev2g"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "UMEE BURN VALIDATOR",
                "website": "https://x.com/umee_man",
                "voting_power": 218482481.802921,
                "commission_rate": 0.05,
                "operator_address": "umeevaloper1fz037eya6ruvklcakq95uftmz6cxw72re9dgkf"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "medium",
                "website": "https://medium-validator.com/",
                "voting_power": 167953342.726768,
                "commission_ra
…(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/umee-api/v1/block"
```

**Response:**
```json
{
    "data": {
        "time": "2026-06-15T02:10:06.424920303Z",
        "chain": "umee-1",
        "height": 23721027,
        "num_txs": 22,
        "proposer_address": "wLtz8d9fdrlimMwCkeuUexrBmAA="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:14.316Z",
        "request_id": "b0085181-756e-4f06-9644-ca0903ebfe1b"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "denom": "UMEE",
        "micro_denom": "uumee",
        "total_supply": 14848199886.891268,
        "total_supply_micro": "14848199886891268"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:14.436Z",
        "request_id": "bd4a01a0-9bf1-41cd-9bc7-7908414a1198"
    },
    "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/umee-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "chain": "umee-1",
        "token": "UMEE",
        "source": "Umee public Cosmos REST/LCD, keyless (3-mirror)",
        "network": "Umee",
        "decimals": 6,
        "examples": {
            "market": "/v1/market?denom=uumee",
            "markets": "/v1/markets?limit=15",
            "bad_debts": "/v1/bad-debts"
        },
        "endpoints": {
            "/v1/block": "latest block (height, time, chain_id)",
            "/v1/market": "full lending summary for one market (denom)",
            "/v1/params": "x/leverage risk parameters (liquidation thresholds & fees)",
            "/v1/supply": "total UMEE supply",
            "/v1/markets": "all registered lending markets with oracle price, supply/borrow APY, liquidity (limit)",
            "/v1/staking": "staking pool, bonded ratio and params",
            "/v1/bad-debts": "addresses currently flagged with bad debt",
            "/v1/validators": "bonded validator set ranked by voting power (limit)"
        },
        "micro_denom": "uumee",
        "cache_ttl_ms": 30000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:14.521Z",
        "request_id": "f34b3136-eefb-417e-a43e-1539a34d21d5"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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