# Aerodrome Finance API > Live protocol metrics for Aerodrome Finance, the leading ve(3,3) decentralized exchange on Base, keyless. Get the total value locked, DEX trading volume (24h / 7d / 30d / all-time, with change), protocol fees, and the liquidity pools with TVL and APY split into trading-fee APY vs AERO emission (incentive) APY — the defining feature of Aerodrome vote-incentivised model — across Basic (v1) and Slipstream (concentrated-liquidity) pools. One combined overview endpoint snapshots it all. Live, nothing stored. The Aerodrome / Base-DeFi metrics layer for dashboards, yield, farming and trading apps — distinct from Ethereum and BSC DEXes, this is Aerodrome on Base specifically, with its emission incentives. ## 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/aerodrome-api/..." ``` ## Pricing - **Free** (Free) — 2,900 calls/Mo, 3 req/s - **Starter** ($17/Mo) — 78,000 calls/Mo, 8 req/s - **Pro** ($56/Mo) — 510,000 calls/Mo, 20 req/s - **Business** ($174/Mo) — 3,300,000 calls/Mo, 50 req/s ## Endpoints ### Overview #### `GET /v1/overview` — Combined Aerodrome snapshot (TVL + volume + fees + top pool) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/aerodrome-api/v1/overview" ``` **Response:** ```json { "data": { "note": "Snapshot of Aerodrome on Base: TVL, DEX volume, fees and the largest pool.", "source": "DeFiLlama", "fees_24h": 171929, "fees_30d": 8615854, "protocol": "Aerodrome", "top_pool": { "apy": 20.01, "tvl": 20848403, "symbol": "USDC-AERO", "fee_apy": null, "pool_id": "d32f9c01-47d1-4077-8c73-8b91b08d1e91", "pool_type": "basic", "stablecoin": false, "volume_24h": null, "emission_apy": 20.01, "incentivized": true }, "total_tvl": 301760612, "volume_7d": 3744273939, "pool_count": 416, "volume_24h": 241438096 }, "meta": { "timestamp": "2026-06-14T08:04:27.249Z", "request_id": "47c72bbd-4b02-458c-9ea6-80b0ed2ba149" }, "status": "ok", "message": "Aerodrome overview retrieved successfully", "success": true } ``` ### Metrics #### `GET /v1/fees` — Aerodrome protocol fees (24h/7d/30d) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/aerodrome-api/v1/fees" ``` **Response:** ```json { "data": { "note": "Trading fees paid by users on Aerodrome, in USD.", "chains": [ "Base" ], "source": "DeFiLlama", "fees_7d": 1749043, "fees_24h": 171929, "fees_30d": 8615854, "protocol": "Aerodrome", "change_1d_pct": -6.82, "change_7d_pct": null, "fees_all_time": 350037279 }, "meta": { "timestamp": "2026-06-14T08:04:27.328Z", "request_id": "f3d21545-f998-4490-b4ab-6ae965f10306" }, "status": "ok", "message": "Aerodrome fees retrieved successfully", "success": true } ``` #### `GET /v1/tvl` — Aerodrome TVL total and per-chain breakdown **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/aerodrome-api/v1/tvl" ``` **Response:** ```json { "data": { "note": "Total value locked in Aerodrome pools, in USD.", "chains": [ { "tvl": 301760610, "chain": "Base" } ], "source": "DeFiLlama", "protocol": "Aerodrome", "total_tvl": 301760612, "chain_count": 1 }, "meta": { "timestamp": "2026-06-14T08:04:27.400Z", "request_id": "37928291-0c25-4c65-b1cc-707b2b958841" }, "status": "ok", "message": "Aerodrome TVL retrieved successfully", "success": true } ``` #### `GET /v1/volume` — Aerodrome DEX trading volume (24h/7d/30d/all-time, with change) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/aerodrome-api/v1/volume" ``` **Response:** ```json { "data": { "note": "DEX trading volume on Aerodrome (Base), in USD.", "chains": [ "Base" ], "source": "DeFiLlama", "protocol": "Aerodrome", "volume_7d": 3744273939, "volume_24h": 241438096, "volume_30d": 17993959833, "change_1d_pct": -43.07, "change_7d_pct": null, "change_30d_pct": null, "volume_all_time": 391420790365 }, "meta": { "timestamp": "2026-06-14T08:04:27.466Z", "request_id": "5a535774-a574-4ebd-b9d1-5636ec7b6077" }, "status": "ok", "message": "Aerodrome volume retrieved successfully", "success": true } ``` ### Pools #### `GET /v1/pools` — Aerodrome pools with fee APY vs AERO emission APY **Parameters:** - `version` (query, optional, string) — Pool type: basic (v1) or cl (slipstream) Example: `cl` - `incentivized` (query, optional, string) — Only pools with AERO emissions (true/false) Example: `true` - `min_tvl` (query, optional, string) — Minimum pool 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 emissions Example: `tvl` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/aerodrome-api/v1/pools?version=cl&incentivized=true&min_tvl=1000000&limit=25&sort=tvl" ``` **Response:** ```json { "data": { "note": "Aerodrome pools. apy = fee_apy + emission_apy; emission_apy is the AERO vote-incentive reward, the defining feature of the ve(3,3) model.", "sort": "tvl", "count": 25, "pools": [ { "apy": 1.76, "tvl": 20833330, "symbol": "WETH-MSETH", "fee_apy": 0.02, "pool_id": "08e1a166-5366-4f57-bef8-76acb53699f0", "pool_type": "concentrated", "stablecoin": false, "volume_24h": 24344.37, "emission_apy": 1.73, "incentivized": true }, { "apy": 3.76, "tvl": 20128569, "symbol": "MSUSD-USDC", "fee_apy": 0.26, "pool_id": "aae6cc3a-783b-4a76-bea7-c3edccd28d62", "pool_type": "concentrated", "stablecoin": true, "volume_24h": 297283.92, "emission_apy": 3.5, "incentivized": true }, { "apy": 29.79, "tvl": 12853358, "symbol": "WETH-CBBTC", "fee_apy": 14.42, "pool_id": "4943b6d2-aad2-4f4d-b56e-93f41ef043aa", "pool_type": "concentrated", "stablecoin": false, "volume_24h": 26758709.13, "emission_apy": 15.37, "incentiviz …(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/aerodrome-api/v1/meta" ``` **Response:** ```json { "data": { "note": "pools takes optional version (basic/v1 or cl/slipstream), incentivized (true/false), min_tvl, limit (1-100) and sort (tvl, apy or emissions). All money values are USD; APYs are percentages. Other endpoints take no parameters.", "sample": { "total_tvl": 301760612, "volume_24h": 241438096 }, "source": "DeFiLlama open API (api.llama.fi + yields.llama.fi), live", "service": "aerodrome-api", "endpoints": { "GET /v1/tvl": "Aerodrome TVL total and per-chain breakdown.", "GET /v1/fees": "Aerodrome protocol fees (24h/7d/30d).", "GET /v1/meta": "This document.", "GET /v1/pools": "Aerodrome pools with fee APY vs AERO emission APY (version, incentivized, sort).", "GET /v1/volume": "Aerodrome DEX trading volume (24h/7d/30d/all-time, with change).", "GET /v1/overview": "Combined Aerodrome snapshot (TVL + volume + fees + top pool)." }, "description": "Live protocol metrics for Aerodrome Finance, the leading ve(3,3) DEX on Base, keyless. Total value locked, DEX trading volume (24h/7d/30d/all-time with change), protocol fees, and the liquidity pools with TVL and APY split into trading-fee APY vs AERO emission (incentive) APY — the defining feature of Aerodrome's vote-incentivised model — across Basic (v1) and Slipstream (concentrated-liquidity) pools. Live, nothing stored beyond a short protective cache. Th …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/aerodrome-api OpenAPI spec: https://www.oanor.com/api/aerodrome-api/openapi.json