# Aave Protocol API
> Live protocol metrics for Aave, the largest decentralized lending protocol, keyless. Get the total value locked across every chain Aave is deployed on, the per-asset lending markets with their supply APY (base + rewards), 30-day average and TVL across Aave v3 / v4, and protocol fees. One combined overview endpoint snapshots it all. Live, nothing stored. The Aave-metrics layer for DeFi dashboards, yield, lending and risk apps — distinct from DEX and generic DeFi/TVL browsers, this is Aave lending markets specifically, multi-chain.

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

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 3 req/s
- **Starter** ($19/Mo) — 75,000 calls/Mo, 8 req/s
- **Pro** ($67/Mo) — 500,000 calls/Mo, 20 req/s
- **Business** ($199/Mo) — 3,500,000 calls/Mo, 50 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Combined Aave snapshot (TVL + fees + markets + top market)

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

**Response:**
```json
{
    "data": {
        "note": "Snapshot of Aave across all chains: TVL, number of markets, fees and the single largest market.",
        "source": "DeFiLlama",
        "fees_24h": 953153,
        "fees_30d": 41761086,
        "protocol": "Aave",
        "total_tvl": 12963156857,
        "top_market": {
            "tvl": 1965844568,
            "asset": "WBTC",
            "chain": "Ethereum",
            "il_risk": "no",
            "pool_id": "7e382157-b1bc-406d-b17b-facba43b716e",
            "version": "v3",
            "total_apy": 0.01,
            "reward_apy": null,
            "stablecoin": false,
            "supply_apy": 0.01,
            "apy_30d_avg": 0.01
        },
        "chain_count": 16,
        "market_count": 236
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:37.956Z",
        "request_id": "e12df54a-0b86-4596-8b1a-c2277d949903"
    },
    "status": "ok",
    "message": "Aave overview retrieved successfully",
    "success": true
}
```

### Metrics

#### `GET /v1/fees` — Aave protocol fees (24h/7d/30d)

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

**Response:**
```json
{
    "data": {
        "note": "Interest and protocol fees paid across all Aave deployments, in USD.",
        "chains": [
            "Ethereum",
            "Polygon",
            "Avalanche",
            "Fantom",
            "Arbitrum",
            "OP Mainnet",
            "Metis",
            "Base",
            "Gnosis",
            "BSC",
            "Scroll",
            "ZKsync Era",
            "Linea",
            "Celo",
            "Sonic",
            "Soneium",
            "Plasma",
            "Mantle",
            "MegaETH",
            "X Layer"
        ],
        "source": "DeFiLlama",
        "fees_7d": 6740439,
        "fees_24h": 953153,
        "fees_30d": 41761086,
        "protocol": "Aave",
        "change_1d_pct": -1.07,
        "change_7d_pct": null,
        "fees_all_time": 2196430476
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:38.044Z",
        "request_id": "408f7d6a-6d55-43a3-a9ae-641b0787feed"
    },
    "status": "ok",
    "message": "Aave fees retrieved successfully",
    "success": true
}
```

#### `GET /v1/tvl` — Aave TVL total and per-chain breakdown

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

**Response:**
```json
{
    "data": {
        "note": "TVL = total assets supplied to Aave (v3 + v4), aggregated from per-market deposits.",
        "chains": [
            {
                "tvl": 9847411446,
                "chain": "Ethereum"
            },
            {
                "tvl": 827124497,
                "chain": "Plasma"
            },
            {
                "tvl": 642028148,
                "chain": "MegaETH"
            },
            {
                "tvl": 369989874,
                "chain": "Arbitrum"
            },
            {
                "tvl": 328596893,
                "chain": "Base"
            },
            {
                "tvl": 249173857,
                "chain": "Avalanche"
            },
            {
                "tvl": 245218662,
                "chain": "Mantle"
            },
            {
                "tvl": 156656028,
                "chain": "BSC"
            },
            {
                "tvl": 109815002,
                "chain": "Polygon"
            },
            {
                "tvl": 70652925,
                "chain": "Xlayer"
            },
            {
                "tvl": 51085883,
                "chain": "Gnosis"
            },
            {
                "tvl": 41377211,
                "chain": "OP Mainnet"
            },
            {
                "tvl": 10166681,
                "chain": "Linea"
            },
            {
                "tvl": 7934658,
                "chain": "Sonic"
            },
  
…(truncated, see openapi.json for full schema)
```

### Markets

#### `GET /v1/markets` — Per-asset Aave lending markets with supply APY and TVL

**Parameters:**
- `version` (query, optional, string) — Aave version: v3 or v4 Example: `v3`
- `chain` (query, optional, string) — Filter by chain (e.g. Ethereum, Base, Arbitrum) Example: `Ethereum`
- `stablecoin` (query, optional, string) — Only stablecoin markets (true/false) Example: `true`
- `min_tvl` (query, optional, string) — Minimum market TVL in USD Example: `1000000`
- `limit` (query, optional, string) — Results (1-100, default 25) Example: `25`
- `sort` (query, optional, string) — Sort by tvl, supply_apy or apy Example: `tvl`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aave-api/v1/markets?version=v3&chain=Ethereum&stablecoin=true&min_tvl=1000000&limit=25&sort=tvl"
```

**Response:**
```json
{
    "data": {
        "sort": "tvl",
        "chain": "Ethereum",
        "count": 25,
        "source": "DeFiLlama",
        "markets": [
            {
                "tvl": 501314022,
                "asset": "USDT",
                "chain": "Ethereum",
                "il_risk": "no",
                "pool_id": "f981a304-bb6c-45b8-b0c5-fd2f515ad23a",
                "version": "v3",
                "total_apy": 2.52,
                "reward_apy": null,
                "stablecoin": true,
                "supply_apy": 2.52,
                "apy_30d_avg": 2.63
            },
            {
                "tvl": 292777508,
                "asset": "SUSDE",
                "chain": "Ethereum",
                "il_risk": "no",
                "pool_id": "29932dea-cd71-44c3-95bd-3e1525f4e3dd",
                "version": "v3",
                "total_apy": 3.11,
                "reward_apy": 3.11,
                "stablecoin": true,
                "supply_apy": 0,
                "apy_30d_avg": 3.02
            },
            {
                "tvl": 207483826,
                "asset": "USDC",
                "chain": "Ethereum",
                "il_risk": "no",
                "pool_id": "aa70268e-4b52-42bf-a116-608b370f9501",
                "version": "v3",
                "total_apy": 3.14,
                "reward_apy": null,
                "stablecoin": true,
                "supply_apy": 3.14,
                "apy_30d_avg": 3.6
            },
            {
             
…(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/aave-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "markets takes optional version (v3, v4), chain (e.g. Ethereum, Base, Arbitrum), stablecoin (true/false), min_tvl, limit (1-100) and sort (tvl, supply_apy or apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.",
        "sample": {
            "total_tvl": 12963156857,
            "market_count": 236
        },
        "source": "DeFiLlama open API (yields.llama.fi + api.llama.fi), live",
        "service": "aave-api",
        "endpoints": {
            "GET /v1/tvl": "Aave TVL total and per-chain breakdown.",
            "GET /v1/fees": "Aave protocol fees (24h/7d/30d).",
            "GET /v1/meta": "This document.",
            "GET /v1/markets": "Per-asset Aave lending markets with supply APY and TVL (version, chain, stablecoin, sort).",
            "GET /v1/overview": "Combined Aave snapshot (TVL + fees + market count + top market)."
        },
        "description": "Live protocol metrics for Aave, the largest decentralized lending protocol, keyless. Total value locked across every chain Aave is deployed on, the per-asset lending markets with supply APY (base + rewards), 30-day average and TVL across Aave v3/v4, and protocol fees. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The Aave-metrics layer for DeFi dashboards, yield, lending and risk apps. Distinct from DEX and generic DeFi/TVL browsers — Aave's lending markets specifically, multi-chain.",
    
…(truncated, see openapi.json for full schema)
```


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