{"openapi":"3.1.0","info":{"title":"Aave Protocol API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/aave-api","description":"oanor gateway"}],"tags":[{"name":"Overview"},{"name":"Metrics"},{"name":"Markets"},{"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 Aave snapshot (TVL + fees + markets + top market)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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}}}},"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":"Aave protocol fees (24h/7d/30d)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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}}}},"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":"Aave TVL total and per-chain breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"},{"tvl":4586528,"chain":"Celo"},{"tvl":1338564,"chain":"Aptos"}],"source":"DeFiLlama","protocol":"Aave","total_tvl":12963156857,"chain_count":16,"market_count":236},"meta":{"timestamp":"2026-06-14T08:04:38.129Z","request_id":"102b67e9-48db-425d-93ad-f7ac4b288f0f"},"status":"ok","message":"Aave 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/markets":{"get":{"operationId":"get_v1_markets","tags":["Markets"],"summary":"Per-asset Aave lending markets with supply APY and TVL","description":"","parameters":[{"name":"version","in":"query","required":false,"description":"Aave version: v3 or v4","schema":{"type":"string"},"example":"v3"},{"name":"chain","in":"query","required":false,"description":"Filter by chain (e.g. Ethereum, Base, Arbitrum)","schema":{"type":"string"},"example":"Ethereum"},{"name":"stablecoin","in":"query","required":false,"description":"Only stablecoin markets (true/false)","schema":{"type":"string"},"example":"true"},{"name":"min_tvl","in":"query","required":false,"description":"Minimum market 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, supply_apy or apy","schema":{"type":"string"},"example":"tvl"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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,"stablecoin":true,"supply_apy":3.14,"apy_30d_avg":3.6},{"tvl":126487211,"asset":"SGHO","chain":"Ethereum","il_risk":"no","pool_id":"19d024ed-9c70-4323-9a81-fe873ea5f0e0","version":"v3","total_apy":4.25,"stablecoin":true,"supply_apy":4.25,"apy_30d_avg":4.25},{"tvl":122656402,"asset":"USDE","chain":"Ethereum","il_risk":"no","pool_id":"21e1ac8a-b3aa-4576-9506-0b40137721a0","version":"v3","total_apy":4.56,"reward_apy":3.11,"stablecoin":true,"supply_apy":1.45,"apy_30d_avg":4.63},{"tvl":117879035,"asset":"USCC","chain":"Ethereum","il_risk":"no","pool_id":"1d5f2f96-3446-4cbc-beba-216677ad7a9d","version":"v3","total_apy":0,"stablecoin":true,"supply_apy":0,"apy_30d_avg":0},{"tvl":85615967,"asset":"USDT","chain":"Ethereum","il_risk":"no","pool_id":"a90d554a-b548-4f50-b03e-9dcb724b7777","version":"v3","total_apy":6.62,"reward_apy":4.1,"stablecoin":true,"supply_apy":2.52,"apy_30d_avg":6.65},{"tvl":73962956,"asset":"USTB","chain":"Ethereum","il_risk":"no","pool_id":"0f23649e-44fb-45be-b8b6-8ff28a0c0917","version":"v3","total_apy":0,"stablecoin":true,"supply_apy":0,"apy_30d_avg":0},{"tvl":65697419,"asset":"RLUSD","chain":"Ethereum","il_risk":"no","pool_id":"98d07333-f5e4-4a48-8061-cfb4b73ccf79","version":"v3","total_apy":5.1,"reward_apy":2.91,"stablecoin":true,"supply_apy":2.19,"apy_30d_avg":4.63},{"tvl":64404787,"asset":"SGHO","chain":"Ethereum","il_risk":"no","pool_id":"ff2a68af-030c-4697-b0a1-b62a738eaef0","version":"v3","total_apy":3.26,"reward_apy":3.26,"stablecoin":true,"apy_30d_avg":3.99},{"tvl":58900324,"asset":"GHO","chain":"Ethereum","il_risk":"no","pool_id":"1e00ac2b-0c3c-4b1f-95be-9378f98d2b40","version":"v3","total_apy":0,"stablecoin":true,"supply_apy":0,"apy_30d_avg":0},{"tvl":54028830,"asset":"USDC","chain":"Ethereum","il_risk":"no","pool_id":"6f00d46b-8735-49ae-9ced-2a0fccc56ad0","version":"v3","total_apy":7.25,"reward_apy":4.11,"stablecoin":true,"supply_apy":3.14,"apy_30d_avg":7.74},{"tvl":28774843,"asset":"GHO","chain":"Ethereum","il_risk":"no","pool_id":"41683a7c-20a2-4cd7-83a7-3ccedaad0db1","version":"v3","total_apy":1.21,"stablecoin":true,"supply_apy":1.21,"apy_30d_avg":1.28},{"tvl":22007521,"asset":"EURC","chain":"Ethereum","il_risk":"no","pool_id":"bdcf8682-1d72-42a7-b23e-f56d666dd10e","version":"v3","total_apy":1.81,"stablecoin":true,"supply_apy":1.81,"apy_30d_avg":1.9},{"tvl":21654387,"asset":"USDTB","chain":"Ethereum","il_risk":"no","pool_id":"baee0253-eb6e-4a08-a579-a2acd4f034b2","version":"v3","total_apy":6.37,"reward_apy":3.4,"stablecoin":true,"supply_apy":2.97,"apy_30d_avg":5.5},{"tvl":16328894,"asset":"GHO","chain":"Ethereum","il_risk":"no","pool_id":"76ffb695-7fcf-418c-a368-4a9a2dc76f70","version":"v3","total_apy":1.96,"stablecoin":true,"supply_apy":1.96,"apy_30d_avg":2.32},{"tvl":14747972,"asset":"GHO","chain":"Ethereum","il_risk":"no","pool_id":"bf0660ab-38bf-48a4-9a6c-393ec0e2ff5f","version":"v3","total_apy":6.5,"reward_apy":6.5,"stablecoin":true,"apy_30d_avg":6.21},{"tvl":11735415,"asset":"USDS","chain":"Ethereum","il_risk":"no","pool_id":"e65588a1-27ad-4e20-9232-68a6cfaccf63","version":"v3","total_apy":0.13,"stablecoin":true,"supply_apy":0.13,"apy_30d_avg":0.13},{"tvl":10052721,"asset":"USDG","chain":"Ethereum","il_risk":"no","pool_id":"83fca810-ec67-401d-831a-2d0ae8e596c9","version":"v3","total_apy":4.18,"stablecoin":true,"supply_apy":4.18,"apy_30d_avg":5.49},{"tvl":8635592,"asset":"DAI","chain":"Ethereum","il_risk":"no","pool_id":"3665ee7e-6c5d-49d9-abb7-c47ab5d9d4ac","version":"v3","total_apy":3.43,"stablecoin":true,"supply_apy":3.43,"apy_30d_avg":2.67},{"tvl":7672598,"asset":"SYRUPUSDT","chain":"Ethereum","il_risk":"no","pool_id":"a79fdd93-2747-43ee-bf53-0c372192964d","version":"v3","total_apy":0,"stablecoin":true,"supply_apy":0,"apy_30d_avg":0},{"tvl":3262557,"asset":"USDC","chain":"Ethereum","il_risk":"no","pool_id":"27296bf9-617a-46e4-9d6d-eefc71e9e0b6","version":"v3","total_apy":2.66,"stablecoin":true,"supply_apy":2.66,"apy_30d_avg":2.78},{"tvl":3055804,"asset":"USDC","chain":"Ethereum","il_risk":"no","pool_id":"effcb4a4-4dcb-45e5-935d-f15542c13e6b","version":"v3","total_apy":1.41,"stablecoin":true,"supply_apy":1.41,"apy_30d_avg":2.93},{"tvl":2406090,"asset":"RLUSD","chain":"Ethereum","il_risk":"no","pool_id":"85fc6934-c94d-4ebe-9c60-66beb363669f","version":"v3","total_apy":2.8,"stablecoin":true,"supply_apy":2.8,"apy_30d_avg":1.96},{"tvl":2130638,"asset":"PYUSD","chain":"Ethereum","il_risk":"no","pool_id":"d118f505-e75f-4152-bad3-49a2dc7482bf","version":"v3","total_apy":3.51,"stablecoin":true,"supply_apy":3.51,"apy_30d_avg":3.24}],"matched":26,"version":"v3","protocol":"Aave"},"meta":{"timestamp":"2026-06-14T08:04:38.191Z","request_id":"92b43ab1-585f-46ca-b628-00ae486881bb"},"status":"ok","message":"Aave markets 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":"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.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:38.271Z","request_id":"c3a9fcc1-f368-4d96-889b-2d39afa25946"},"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":2500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1900,"monthly_call_quota":75000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":6700,"monthly_call_quota":500000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":19900,"monthly_call_quota":3500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/aave-api"}