{"openapi":"3.1.0","info":{"title":"Aerodrome Finance API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/aerodrome-api","description":"oanor gateway"}],"tags":[{"name":"Overview"},{"name":"Metrics"},{"name":"Pools"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/overview":{"get":{"operationId":"get_v1_overview","tags":["Overview"],"summary":"Combined Aerodrome snapshot (TVL + volume + fees + top pool)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","pool_id":"d32f9c01-47d1-4077-8c73-8b91b08d1e91","pool_type":"basic","stablecoin":false,"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/fees":{"get":{"operationId":"get_v1_fees","tags":["Metrics"],"summary":"Aerodrome protocol fees (24h/7d/30d)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/tvl":{"get":{"operationId":"get_v1_tvl","tags":["Metrics"],"summary":"Aerodrome TVL total and per-chain breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/volume":{"get":{"operationId":"get_v1_volume","tags":["Metrics"],"summary":"Aerodrome DEX trading volume (24h/7d/30d/all-time, with change)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/pools":{"get":{"operationId":"get_v1_pools","tags":["Pools"],"summary":"Aerodrome pools with fee APY vs AERO emission APY","description":"","parameters":[{"name":"version","in":"query","required":false,"description":"Pool type: basic (v1) or cl (slipstream)","schema":{"type":"string"},"example":"cl"},{"name":"incentivized","in":"query","required":false,"description":"Only pools with AERO emissions (true/false)","schema":{"type":"string"},"example":"true"},{"name":"min_tvl","in":"query","required":false,"description":"Minimum pool TVL in USD","schema":{"type":"string"},"example":"1000000"},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 25)","schema":{"type":"string"},"example":"25"},{"name":"sort","in":"query","required":false,"description":"Sort by tvl, apy or emissions","schema":{"type":"string"},"example":"tvl"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"incentivized":true},{"apy":43.68,"tvl":10040932,"symbol":"USDC-CBBTC","fee_apy":23.79,"pool_id":"ff82c362-dea1-4946-b3b1-92ebd5100b1e","pool_type":"concentrated","stablecoin":false,"volume_24h":33954834.23,"emission_apy":19.89,"incentivized":true},{"apy":37.06,"tvl":8967381,"symbol":"WETH-USDC","fee_apy":10.95,"pool_id":"10137e20-efbc-4e15-a733-17ecb52c48e8","pool_type":"concentrated","stablecoin":false,"volume_24h":38961728.17,"emission_apy":26.12,"incentivized":true},{"apy":30.46,"tvl":4043734,"symbol":"VVV-DIEM","pool_id":"c5bfb4c1-f788-4d05-8714-42c603c81534","pool_type":"concentrated","stablecoin":false,"emission_apy":30.46,"incentivized":true},{"apy":5.13,"tvl":3969148,"symbol":"CBBTC-LBTC","fee_apy":0,"pool_id":"ff009fa1-2dda-43e0-a0e2-302787e736c8","pool_type":"concentrated","stablecoin":false,"volume_24h":2433.77,"emission_apy":5.12,"incentivized":true},{"apy":1.5,"tvl":3492319,"symbol":"WETH-SUPEROETHB","fee_apy":0,"pool_id":"bc33d1ea-f566-40eb-b0a8-8d8dcf425f18","pool_type":"concentrated","stablecoin":false,"volume_24h":129.92,"emission_apy":1.5,"incentivized":true},{"apy":114.73,"tvl":3483611,"symbol":"WETH-CBBTC","pool_id":"07eda095-9e08-4f82-ad79-2225c60ed229","pool_type":"concentrated","stablecoin":false,"emission_apy":114.73,"incentivized":true},{"apy":404318.75,"tvl":3397751,"symbol":"USDC-VELVET","fee_apy":6.92,"pool_id":"c07a115f-7299-4dd1-ac25-2de459010b6b","pool_type":"concentrated","stablecoin":false,"volume_24h":6448811.91,"emission_apy":404311.82,"incentivized":true},{"apy":6.59,"tvl":3218885,"symbol":"EURC-USDC","fee_apy":2.68,"pool_id":"847c874f-d4e7-47ed-8870-97d2f24a8767","pool_type":"concentrated","stablecoin":true,"volume_24h":589352.57,"emission_apy":3.91,"incentivized":true},{"apy":119.72,"tvl":3027956,"symbol":"WETH-USDC","pool_id":"1328ac9d-9939-4719-a85a-114935209e08","pool_type":"concentrated","stablecoin":false,"emission_apy":119.72,"incentivized":true},{"apy":107.52,"tvl":2887357,"symbol":"USDC-CBBTC","pool_id":"6f1786fc-a22f-4c46-91cd-d3792479bdc2","pool_type":"concentrated","stablecoin":false,"emission_apy":107.52,"incentivized":true},{"apy":121.36,"tvl":2871359,"symbol":"USDC-CBBTC","fee_apy":101.59,"pool_id":"bf599ba2-97ae-48bb-9fd0-4f647ad7a832","pool_type":"concentrated","stablecoin":false,"volume_24h":1162689.05,"emission_apy":19.77,"incentivized":true},{"apy":8.79,"tvl":2786473,"symbol":"WETH-AERO","pool_id":"3aebe700-db0b-49e2-82f6-564acdfae434","pool_type":"concentrated","stablecoin":false,"emission_apy":8.79,"incentivized":true},{"apy":51.02,"tvl":1773800,"symbol":"WETH-REI","pool_id":"4b4071bc-944d-4838-b696-624e21a3a383","pool_type":"concentrated","stablecoin":false,"emission_apy":51.02,"incentivized":true},{"apy":49.39,"tvl":1752504,"symbol":"USDC-AERO","fee_apy":8.04,"pool_id":"31ed7657-e02c-427b-8e3e-c0bf24e6cb9b","pool_type":"concentrated","stablecoin":false,"volume_24h":80615.59,"emission_apy":41.35,"incentivized":true},{"apy":31.53,"tvl":1696795,"symbol":"WETH-ZEN","fee_apy":3.47,"pool_id":"6e7d0984-9a39-4619-86e2-13b9aae221b8","pool_type":"concentrated","stablecoin":false,"volume_24h":456511.58,"emission_apy":28.06,"incentivized":true},{"apy":2.1,"tvl":1645326,"symbol":"WETH-WSTETH","fee_apy":1.26,"pool_id":"05bd3778-2cb9-424d-a4bc-5707f8612a75","pool_type":"concentrated","stablecoin":false,"volume_24h":639657.08,"emission_apy":0.84,"incentivized":true},{"apy":3.02,"tvl":1468949,"symbol":"CBETH-WETH","fee_apy":0.93,"pool_id":"dc5b6771-96a6-4b38-b1c3-912544c23899","pool_type":"concentrated","stablecoin":false,"volume_24h":439356.01,"emission_apy":2.1,"incentivized":true},{"apy":3.12,"tvl":1365143,"symbol":"AERO-CBBTC","pool_id":"3707d5ff-690b-423b-b3bb-4b7c7cca2990","pool_type":"concentrated","stablecoin":false,"emission_apy":3.12,"incentivized":true},{"apy":12.76,"tvl":1297088,"symbol":"MSUSD-MSETH","pool_id":"3fea9aec-48b6-4ad3-bd04-f69188bead1d","pool_type":"concentrated","stablecoin":false,"emission_apy":12.76,"incentivized":true},{"apy":9.76,"tvl":1253563,"symbol":"USDZ-SUSDZ","fee_apy":0,"pool_id":"35ac31e6-8398-4ad7-a0af-3374482de112","pool_type":"concentrated","stablecoin":true,"volume_24h":1.4,"emission_apy":9.76,"incentivized":true},{"apy":63.16,"tvl":1119969,"symbol":"WETH-VVV","pool_id":"7185982b-0632-4e70-89ca-441c2f0b2618","pool_type":"concentrated","stablecoin":false,"emission_apy":63.16,"incentivized":true},{"apy":10.67,"tvl":1099172,"symbol":"USDC-USDT","fee_apy":8.39,"pool_id":"ba557f7e-f287-45a9-bc37-8f3a24ca05c7","pool_type":"concentrated","stablecoin":true,"volume_24h":2864763.45,"emission_apy":2.28,"incentivized":true}],"source":"DeFiLlama","matched":27,"version":"cl","protocol":"Aerodrome"},"meta":{"timestamp":"2026-06-14T08:04:27.542Z","request_id":"e3ae4bdf-60e6-4f2a-8b13-c4e39f43beff"},"status":"ok","message":"Aerodrome pools retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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. The Aerodrome / Base-DeFi metrics layer for dashboards, yield, farming and trading apps. Distinct from Ethereum and BSC DEXes — Aerodrome on Base specifically, with its emission incentives.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:27.618Z","request_id":"b3de136b-d88b-41ea-8ddd-7b3258ff454f"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2900,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1650,"monthly_call_quota":78000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5600,"monthly_call_quota":510000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":17400,"monthly_call_quota":3300000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/aerodrome-api"}