# Liquity Protocol API
> Live protocol metrics for Liquity, the original immutable decentralized borrowing protocol that issues the LUSD and BOLD stablecoins against ETH and liquid-staking-token collateral, keyless. Get the total collateral locked, the breakdown of which assets back the stablecoins (ETH, wstETH, rETH across Liquity v1 + v2), per-chain TVL, and the Liquity pools (stability pools / earning positions) with their APY. One combined overview endpoint snapshots it all. Live, nothing stored. The CDP / decentralized-stablecoin metrics layer for DeFi dashboards, stablecoin, risk and yield apps — distinct from DEX, lending, restaking and yield protocols, this is Liquity collateralized-debt model 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/liquity-api/..."
```

## Pricing
- **Free** (Free) — 2,300 calls/Mo, 3 req/s
- **Starter** ($14/Mo) — 58,000 calls/Mo, 8 req/s
- **Pro** ($47/Mo) — 360,000 calls/Mo, 20 req/s
- **Business** ($144/Mo) — 2,400,000 calls/Mo, 50 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Combined Liquity snapshot (collateral + assets + best pool)

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

**Response:**
```json
{
    "data": {
        "note": "Snapshot of Liquity: total collateral, the assets backing LUSD/BOLD, and the best-earning pool.",
        "source": "DeFiLlama",
        "protocol": "Liquity",
        "best_pool": {
            "apy": 2.75,
            "symbol": "BOLD",
            "version": "v2"
        },
        "pool_count": 7,
        "chain_count": 1,
        "top_collateral": {
            "usd": 137995829.3,
            "asset": "WETH",
            "share_pct": 69.78
        },
        "total_collateral_usd": 197759953.66,
        "collateral_asset_count": 3
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:28.949Z",
        "request_id": "966d90c2-1025-404b-b6d2-23e95d66b103"
    },
    "status": "ok",
    "message": "Liquity overview retrieved successfully",
    "success": true
}
```

### Metrics

#### `GET /v1/tvl` — Total collateral locked in Liquity (total + per-chain)

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

**Response:**
```json
{
    "data": {
        "note": "Total collateral locked in Liquity backing the LUSD / BOLD stablecoins, in USD.",
        "chains": [
            {
                "tvl": 197759952,
                "chain": "Ethereum"
            }
        ],
        "source": "DeFiLlama",
        "protocol": "Liquity",
        "chain_count": 1,
        "total_collateral_usd": 197759953.66
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:29.012Z",
        "request_id": "a4a72e6d-0ee6-438c-8634-935f546a0777"
    },
    "status": "ok",
    "message": "Liquity TVL retrieved successfully",
    "success": true
}
```

### Collateral

#### `GET /v1/collateral` — Assets backing LUSD/BOLD — ETH and LSTs, by USD and share

**Parameters:**
- `limit` (query, optional, string) — Results (1-100, default 25) Example: `25`
- `min_usd` (query, optional, string) — Minimum asset value in USD Example: `1000000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/liquity-api/v1/collateral?limit=25&min_usd=1000000"
```

**Response:**
```json
{
    "data": {
        "note": "Assets backing Liquity's LUSD / BOLD stablecoins (ETH and liquid-staking tokens), by USD value and share.",
        "count": 3,
        "source": "DeFiLlama",
        "protocol": "Liquity",
        "collateral": [
            {
                "usd": 137995829.3,
                "asset": "WETH",
                "share_pct": 69.78
            },
            {
                "usd": 47895287.5,
                "asset": "WSTETH",
                "share_pct": 24.22
            },
            {
                "usd": 11868836.86,
                "asset": "RETH",
                "share_pct": 6
            }
        ],
        "asset_count": 3
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:29.074Z",
        "request_id": "1c7e0ba3-368c-4f0e-8676-ce1c8d79c7c7"
    },
    "status": "ok",
    "message": "Liquity collateral retrieved successfully",
    "success": true
}
```

### Pools

#### `GET /v1/pools` — Liquity pools (stability pools / deposits) with APY

**Parameters:**
- `version` (query, optional, string) — Liquity version: v1 or v2 Example: `v2`
- `earning` (query, optional, string) — Only pools that earn yield (true/false) Example: `true`
- `sort` (query, optional, string) — Sort by tvl or apy Example: `apy`
- `limit` (query, optional, string) — Results (1-100, default 25) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/liquity-api/v1/pools?version=v2&earning=true&sort=apy&limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "Liquity pools — stability pools and deposit positions across v1 and v2; the BOLD stability pool earns yield.",
        "sort": "apy",
        "count": 3,
        "pools": [
            {
                "apy": 2.75,
                "tvl": 2596967,
                "chain": "Ethereum",
                "symbol": "BOLD",
                "pool_id": "326739f2-4650-4992-a8eb-a400e7790499",
                "version": "v2",
                "apy_base": null,
                "apy_reward": null,
                "stablecoin": true
            },
            {
                "apy": 1.78,
                "tvl": 10281955,
                "chain": "Ethereum",
                "symbol": "BOLD",
                "pool_id": "dac71f4f-7b97-463a-b19f-9796c56c21f1",
                "version": "v2",
                "apy_base": null,
                "apy_reward": null,
                "stablecoin": true
            },
            {
                "apy": 1.77,
                "tvl": 6859447,
                "chain": "Ethereum",
                "symbol": "BOLD",
                "pool_id": "a635df9a-4cfc-4d17-86d0-934ea441e79f",
                "version": "v2",
                "apy_base": null,
                "apy_reward": null,
                "stablecoin": true
            }
        ],
        "source": "DeFiLlama",
        "matched": 3,
        "version": "v2",
        "protocol": "Liquity"
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:29.159Z",
     
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata & live sample

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

**Response:**
```json
{
    "data": {
        "note": "collateral takes optional limit (1-100) and min_usd. pools takes optional version (v1, v2), earning (true/false) and sort (tvl or apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.",
        "sample": {
            "top_collateral": "WETH",
            "total_collateral_usd": 197759953.66
        },
        "source": "DeFiLlama open API (api.llama.fi + yields.llama.fi), live",
        "service": "liquity-api",
        "endpoints": {
            "GET /v1/tvl": "Total collateral locked in Liquity (total + per-chain).",
            "GET /v1/meta": "This document.",
            "GET /v1/pools": "Liquity pools (stability pools / deposits) with APY (version, earning, sort).",
            "GET /v1/overview": "Combined Liquity snapshot (collateral + assets + best pool).",
            "GET /v1/collateral": "Assets backing LUSD/BOLD — ETH and LSTs, by USD and share."
        },
        "description": "Live protocol metrics for Liquity, the original immutable decentralized borrowing protocol issuing the LUSD and BOLD stablecoins against ETH and LST collateral, keyless. Total collateral locked, the breakdown of which assets back the stablecoins (ETH, wstETH, rETH across v1 + v2), per-chain TVL, and the Liquity pools (stability pools) with APY. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The CDP / decentralized-stablecoin metrics layer for DeFi dashboards, stablecoin
…(truncated, see openapi.json for full schema)
```


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