# Fluid Protocol API
> Live protocol metrics for Fluid (by Instadapp), the hybrid DeFi protocol that combines a lending money-market AND a DEX in one capital-efficient system (smart collateral / smart debt), keyless. Get the total value locked, the DEX trading volume, protocol fees, and the positions across all three Fluid products — the DEX, the lending markets and Fluid Lite (vaults) — each with TVL and supply APY. One combined overview endpoint snapshots it all. Live, nothing stored. The Fluid-metrics layer for DeFi dashboards, lending, DEX, yield and risk apps — distinct from pure DEX, pure lending and generic TVL browsers, this is Fluid hybrid lending-plus-DEX 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/fluid-api/..."
```

## Pricing
- **Free** (Free) — 3,300 calls/Mo, 3 req/s
- **Starter** ($20/Mo) — 88,000 calls/Mo, 8 req/s
- **Pro** ($65/Mo) — 600,000 calls/Mo, 20 req/s
- **Business** ($196/Mo) — 3,900,000 calls/Mo, 50 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Combined Fluid snapshot (TVL + DEX volume + fees + TVL by product + top pool)

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

**Response:**
```json
{
    "data": {
        "note": "Snapshot of Fluid's hybrid model: total TVL, DEX volume, fees and the largest position.",
        "source": "DeFiLlama",
        "fees_30d": 3840872,
        "protocol": "Fluid",
        "top_pool": {
            "tvl": 128104333,
            "chain": "Ethereum",
            "symbol": "WSTETH",
            "pool_id": "69b12bf9-edb6-46d9-b5bc-761cf9efe137",
            "product": "lending",
            "total_apy": 0.05,
            "reward_apy": null,
            "stablecoin": false,
            "supply_apy": 0.05
        },
        "total_tvl": 954646375.25,
        "pool_count": 188,
        "chain_count": 5,
        "dex_volume_24h": 56066949,
        "tvl_by_product_top100": {
            "dex": 250561918,
            "lite": 152814606,
            "lending": 935920140
        }
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:25.371Z",
        "request_id": "4e811c78-6256-4e1d-90ef-3a056ef2f9fa"
    },
    "status": "ok",
    "message": "Fluid overview retrieved successfully",
    "success": true
}
```

### Metrics

#### `GET /v1/dex` — Fluid DEX trading volume and protocol fees (24h/7d/30d)

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

**Response:**
```json
{
    "data": {
        "note": "Fluid's DEX trading volume and the protocol's fees, in USD.",
        "source": "DeFiLlama",
        "fees_7d": 846521,
        "fees_24h": 92874,
        "fees_30d": 3840872,
        "protocol": "Fluid",
        "dex_volume_7d": 1063982838,
        "dex_volume_24h": 56066949,
        "dex_volume_30d": 5285499517,
        "dex_volume_all_time": 225505511809
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:25.455Z",
        "request_id": "d5c0e602-c27d-4caa-846d-5243a48df9f3"
    },
    "status": "ok",
    "message": "Fluid DEX metrics retrieved successfully",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "note": "Total value locked across Fluid's lending, DEX and Lite products, in USD.",
        "chains": [
            {
                "tvl": 458763911,
                "chain": "Ethereum"
            },
            {
                "tvl": 113238325,
                "chain": "Arbitrum"
            },
            {
                "tvl": 112131814,
                "chain": "Plasma"
            },
            {
                "tvl": 19539805,
                "chain": "Base"
            },
            {
                "tvl": 3350253,
                "chain": "Polygon"
            }
        ],
        "source": "DeFiLlama",
        "protocol": "Fluid",
        "total_tvl": 954646375.25,
        "chain_count": 5
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:25.543Z",
        "request_id": "2bf2b5e5-ccd7-4904-8835-cf3debc57ae9"
    },
    "status": "ok",
    "message": "Fluid TVL retrieved successfully",
    "success": true
}
```

### Pools

#### `GET /v1/pools` — Positions across Fluid dex / lending / lite products with TVL and APY

**Parameters:**
- `product` (query, optional, string) — Fluid product: dex, lending or lite Example: `lending`
- `chain` (query, optional, string) — Filter by chain (e.g. Ethereum, Arbitrum, Base) Example: `Ethereum`
- `min_tvl` (query, optional, string) — Minimum position TVL in USD Example: `1000000`
- `limit` (query, optional, string) — Results (1-100, default 25) Example: `25`
- `sort` (query, optional, string) — Sort by tvl, apy or supply_apy Example: `tvl`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fluid-api/v1/pools?product=lending&chain=Ethereum&min_tvl=1000000&limit=25&sort=tvl"
```

**Response:**
```json
{
    "data": {
        "note": "Positions across all three Fluid products: dex (trading pools), lending (money markets) and lite (vaults).",
        "sort": "tvl",
        "chain": "Ethereum",
        "count": 25,
        "pools": [
            {
                "tvl": 128104333,
                "chain": "Ethereum",
                "symbol": "WSTETH",
                "pool_id": "69b12bf9-edb6-46d9-b5bc-761cf9efe137",
                "product": "lending",
                "total_apy": 0.05,
                "reward_apy": null,
                "stablecoin": false,
                "supply_apy": 0.05
            },
            {
                "tvl": 107740408,
                "chain": "Ethereum",
                "symbol": "USDT",
                "pool_id": "4e8cc592-c8d5-4824-8155-128ba521e903",
                "product": "lending",
                "total_apy": 4.43,
                "reward_apy": 1.19,
                "stablecoin": true,
                "supply_apy": 3.24
            },
            {
                "tvl": 105946265,
                "chain": "Ethereum",
                "symbol": "USDC",
                "pool_id": "4438dabc-7f0c-430b-8136-2722711ae663",
                "product": "lending",
                "total_apy": 5.31,
                "reward_apy": 1.21,
                "stablecoin": true,
                "supply_apy": 4.1
            },
            {
                "tvl": 68708028,
                "chain": "Ethereum",
                "symbol": "ETH",
    
…(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/fluid-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "pools takes optional product (dex, lending or lite), chain (e.g. Ethereum, Arbitrum, Base), min_tvl, limit (1-100) and sort (tvl, apy or supply_apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.",
        "sample": {
            "total_tvl": 954646375.25,
            "dex_volume_24h": 56066949
        },
        "source": "DeFiLlama open API (api.llama.fi + yields.llama.fi), live",
        "service": "fluid-api",
        "endpoints": {
            "GET /v1/dex": "Fluid's DEX trading volume and protocol fees (24h/7d/30d).",
            "GET /v1/tvl": "Fluid TVL total and per-chain breakdown.",
            "GET /v1/meta": "This document.",
            "GET /v1/pools": "Positions across Fluid's dex / lending / lite products with TVL and APY (product, chain, sort).",
            "GET /v1/overview": "Combined Fluid snapshot (TVL + DEX volume + fees + TVL by product + top pool)."
        },
        "description": "Live protocol metrics for Fluid (by Instadapp), the hybrid DeFi protocol combining a lending money-market AND a DEX in one capital-efficient system, keyless. Total value locked, DEX trading volume, protocol fees, and the positions across all three Fluid products — the DEX, the lending markets and Fluid Lite (vaults) — each with TVL and supply APY. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The Fluid-metrics layer for DeFi dashboards, lending, DEX,
…(truncated, see openapi.json for full schema)
```


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