# Curve Finance DeFi API
> Live DeFi data from Curve Finance — the dominant decentralised exchange for stablecoins and pegged assets (StableSwap AMM) — served from its public API as clean JSON, no cache. List every chain Curve runs on and the pool registries on each; pull the liquidity pools on a chain/registry with each pool's USD TVL, underlying coins and prices, amplification coefficient, virtual price and CRV gauge APY (sorted by TVL); fetch one pool's full detail by address; or read a chain's total and per-pool trading volume. Read live from Curve, nothing cached. This is Curve's own StableSwap pool, TVL and gauge layer across Ethereum and 20+ L2s — distinct from on-chain explorers, general DEX-pool feeds and price APIs: protocol-level data for the largest stablecoin AMM in DeFi.

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

## Pricing
- **Free** (Free) — 900 calls/Mo, 3 req/s
- **Starter** ($11/Mo) — 33,000 calls/Mo, 12 req/s
- **Pro** ($31/Mo) — 175,000 calls/Mo, 28 req/s
- **Business** ($73/Mo) — 880,000 calls/Mo, 55 req/s

## Endpoints

### Platforms

#### `GET /v1/platforms` — Every chain Curve runs on and its pool registries

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

**Response:**
```json
{
    "data": {
        "count": 21,
        "source": "Curve Finance",
        "platforms": [
            {
                "chain": "arbitrum",
                "registries": [
                    "main",
                    "factory",
                    "crypto",
                    "factory-twocrypto",
                    "factory-tricrypto",
                    "factory-stable-ng"
                ]
            },
            {
                "chain": "aurora",
                "registries": [
                    "main",
                    "factory-twocrypto",
                    "factory-tricrypto",
                    "factory-stable-ng"
                ]
            },
            {
                "chain": "avalanche",
                "registries": [
                    "main",
                    "factory",
                    "crypto",
                    "factory-twocrypto",
                    "factory-tricrypto",
                    "factory-stable-ng"
                ]
            },
            {
                "chain": "base",
                "registries": [
                    "factory",
                    "factory-crypto",
                    "factory-twocrypto",
                    "factory-tricrypto",
                    "factory-stable-ng"
                ]
            },
            {
                "chain": "bsc",
                "registries": [
                    "factory",
                    "factory-crypto",
                    "factory-twocryp
…(truncated, see openapi.json for full schema)
```

### Pools

#### `GET /v1/pools` — Pools on a chain/registry with TVL, coins, amp and gauge APY

**Parameters:**
- `chain` (query, optional, string) — Chain Example: `ethereum`
- `registry` (query, optional, string) — Pool registry Example: `main`
- `limit` (query, optional, string) — Max pools (1-500) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/curve-api/v1/pools?chain=ethereum&registry=main&limit=50"
```

**Response:**
```json
{
    "data": {
        "chain": "ethereum",
        "count": 49,
        "pools": [
            {
                "id": "0",
                "name": "Curve.fi DAI/USDC/USDT",
                "coins": [
                    {
                        "symbol": "DAI",
                        "usd_price": 1.000047
                    },
                    {
                        "symbol": "USDC",
                        "usd_price": 1
                    },
                    {
                        "symbol": "USDT",
                        "usd_price": 0.999329
                    }
                ],
                "symbol": "3Crv",
                "address": "0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7",
                "tvl_usd": 160718478.86,
                "is_broken": false,
                "asset_type": "usd",
                "is_meta_pool": false,
                "amplification": 4000,
                "gauge_crv_apy": {
                    "max": 0.0001,
                    "min": 0
                },
                "virtual_price": "1039823717242480120"
            },
            {
                "id": "14",
                "name": "Curve.fi ETH/stETH",
                "coins": [
                    {
                        "symbol": "ETH",
                        "usd_price": 1613.851717
                    },
                    {
                        "symbol": "stETH",
                        "usd_price": 1614.510185
                    }
               
…(truncated, see openapi.json for full schema)
```

### Pool

#### `GET /v1/pool` — One pool's full detail by address

**Parameters:**
- `address` (query, required, string) — Pool contract address Example: `0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7`
- `chain` (query, optional, string) — Chain Example: `ethereum`
- `registry` (query, optional, string) — Pool registry Example: `main`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/curve-api/v1/pool?address=0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7&chain=ethereum&registry=main"
```

**Response:**
```json
{
    "data": {
        "id": "0",
        "name": "Curve.fi DAI/USDC/USDT",
        "chain": "ethereum",
        "coins": [
            {
                "symbol": "DAI",
                "usd_price": 1.000047
            },
            {
                "symbol": "USDC",
                "usd_price": 1
            },
            {
                "symbol": "USDT",
                "usd_price": 0.999329
            }
        ],
        "source": "Curve Finance",
        "symbol": "3Crv",
        "address": "0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7",
        "tvl_usd": 160718478.86,
        "registry": "main",
        "is_broken": false,
        "asset_type": "usd",
        "is_meta_pool": false,
        "amplification": 4000,
        "gauge_crv_apy": {
            "max": 0.0001,
            "min": 0
        },
        "virtual_price": "1039823717242480120"
    },
    "meta": {
        "timestamp": "2026-06-10T22:58:16.510Z",
        "request_id": "deb7eabc-f1f4-43e4-818a-60875dbe8214"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

### Volumes

#### `GET /v1/volumes` — A chain's total and per-pool trading volume

**Parameters:**
- `chain` (query, optional, string) — Chain Example: `ethereum`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/curve-api/v1/volumes?chain=ethereum"
```

**Response:**
```json
{
    "data": {
        "chain": "ethereum",
        "source": "Curve Finance",
        "pool_count": 2306,
        "crypto_share_pct": null,
        "total_volume_usd": 166219011.1,
        "crypto_volume_usd": null,
        "top_pools_by_volume": [
            {
                "address": "0xA632D59b9B804a956BfaA9b48Af3A1b74808FC1f",
                "volume_usd": 36137850.25
            },
            {
                "address": "0x4f493B7dE8aAC7d55F71853688b1F7C8F0243C85",
                "volume_usd": 23144687.01
            },
            {
                "address": "0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7",
                "volume_usd": 15127218.63
            },
            {
                "address": "0x00836Fe54625BE242BcFA286207795405ca4fD10",
                "volume_usd": 14384452.32
            },
            {
                "address": "0x390f3595bCa2Df7d23783dFd126427CCeb997BF4",
                "volume_usd": 7421724.92
            },
            {
                "address": "0xc061caa073f3d95F80f8e5428d32D2d76F5e1622",
                "volume_usd": 4885390.91
            },
            {
                "address": "0xE1B96555BbecA40E583BbB41a11C68Ca4706A414",
                "volume_usd": 4119622.72
            },
            {
                "address": "0x4DEcE678ceceb27446b35C672dC7d61F30bAD69E",
                "volume_usd": 4111612.62
            },
            {
                "address": "0xD51a44d3FaE010294C616388b506AcdA1bfAAE46",
              
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "source": "Curve Finance API (api.curve.finance, live)",
        "service": "curve-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pool": "One pool's full detail by address (chain=ethereum, registry=main, address=0x...).",
            "GET /v1/pools": "Pools on a chain/registry with TVL, coins, amp, gauge APY (chain=ethereum, registry=main, limit=50).",
            "GET /v1/volumes": "A chain's total and per-pool trading volume (chain=ethereum).",
            "GET /v1/platforms": "Every chain Curve runs on and its pool registries."
        },
        "chain_count": 21,
        "description": "Live DeFi data from Curve Finance, the dominant decentralised exchange for stablecoins and pegged assets (StableSwap AMM), via its public API. The platforms endpoint lists every chain Curve runs on and the pool registries on each; the pools endpoint returns a chain/registry's liquidity pools with USD TVL, underlying coins and prices, amplification coefficient, virtual price and CRV gauge APY, sorted by TVL; the pool endpoint returns one pool's full detail by address; the volumes endpoint returns the chain's total trading volume and per-pool volume. Live, no key, nothing stored. Distinct from on-chain explorers, general DEX-pool feeds and price APIs — this is Curve's own StableSwap pool, TVL and gauge layer across Ethereum and many L2s.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "202
…(truncated, see openapi.json for full schema)
```


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