{"openapi":"3.1.0","info":{"title":"Compound Protocol API","version":"1.0.0","description":"Live protocol metrics for Compound Finance, one of the original decentralized lending protocols, keyless. Get the total value locked across every chain Compound is deployed on, the per-asset markets across Compound v2 and v3 (Comet) with supply APY and TVL — including the v3 distinction where collateral assets back a single borrowable base asset and do not earn yield (earns_yield) — and protocol fees. One combined overview endpoint snapshots it all. Live, nothing stored. The Compound-metrics layer for DeFi dashboards, lending, yield and risk apps — distinct from other lending protocols, this is Compound own markets, v2 + v3, multi-chain.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/compound-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 Compound snapshot (TVL + fees + markets + top market)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Snapshot of Compound across all chains: TVL, number of markets, fees and the single largest market.","source":"DeFiLlama","fees_24h":54430,"fees_30d":1738515,"protocol":"Compound","total_tvl":1153780222.65,"top_market":{"tvl":306503650,"asset":"WBTC","chain":"Ethereum","pool_id":"c1ca08e4-d618-415e-ad63-fcec58705469","version":"v3","stablecoin":false,"apy_30d_avg":0,"earns_yield":false},"chain_count":9,"market_count":119},"meta":{"timestamp":"2026-06-14T08:04:30.400Z","request_id":"05ecd865-98f1-4c8b-b401-bd01723cf981"},"status":"ok","message":"Compound 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":"Compound 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 Compound deployments, in USD.","chains":["Ethereum","Polygon","Scroll","Mantle","OP Mainnet","Base","Arbitrum","Linea","Unichain"],"source":"DeFiLlama","fees_7d":368232,"fees_24h":54430,"fees_30d":1738515,"protocol":"Compound","change_1d_pct":1.26,"fees_all_time":568117881},"meta":{"timestamp":"2026-06-14T08:04:30.475Z","request_id":"2629c2fa-1e3f-48e6-8cce-c7c959340b5f"},"status":"ok","message":"Compound 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":"Compound TVL total and per-chain breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Total value supplied to Compound (v2 + v3), in USD.","chains":[{"tvl":1052630613,"chain":"Ethereum"},{"tvl":63284681,"chain":"Arbitrum"},{"tvl":20103799,"chain":"Base"},{"tvl":10449732,"chain":"OP Mainnet"},{"tvl":5732406,"chain":"Polygon"},{"tvl":1701718,"chain":"Mantle"},{"tvl":1020617,"chain":"Unichain"},{"tvl":103655,"chain":"Ronin"},{"tvl":97521,"chain":"Scroll"}],"source":"DeFiLlama","protocol":"Compound","total_tvl":1153780222.65,"chain_count":9},"meta":{"timestamp":"2026-06-14T08:04:30.560Z","request_id":"579f3cd4-1e7a-43fc-8628-f70937e708f7"},"status":"ok","message":"Compound 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 Compound v2/v3 markets with supply APY, TVL and earns_yield","description":"","parameters":[{"name":"version","in":"query","required":false,"description":"Compound version: v2 or v3","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":"earning","in":"query","required":false,"description":"Only markets that earn supply yield (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":{"note":"Compound v2 + v3 markets. In v3 (Comet), collateral assets do not earn yield (earns_yield=false); only base assets do.","sort":"tvl","chain":"Ethereum","count":3,"source":"DeFiLlama","markets":[{"tvl":47442549,"asset":"USDT","chain":"Ethereum","pool_id":"f4d5b566-e815-4ca2-bb07-7bcd8bc797f1","version":"v3","reward_apy":0.1,"stablecoin":true,"supply_apy":2.69,"apy_30d_avg":2.77,"earns_yield":true},{"tvl":43620148,"asset":"USDC","chain":"Ethereum","pool_id":"7da72d09-56ca-4ec5-a45f-59114353e487","version":"v3","reward_apy":0.11,"stablecoin":true,"supply_apy":3.12,"apy_30d_avg":3.45,"earns_yield":true},{"tvl":10688036,"asset":"ETH","chain":"Ethereum","pool_id":"85c57261-b75b-4447-a115-d79b1a7de8ed","version":"v3","reward_apy":0.07,"stablecoin":false,"supply_apy":1.76,"apy_30d_avg":1.6,"earns_yield":true}],"matched":3,"version":"v3","protocol":"Compound"},"meta":{"timestamp":"2026-06-14T08:04:30.652Z","request_id":"120c6ab2-295c-42c8-8b22-a20f8b2c9b27"},"status":"ok","message":"Compound 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 (v2, v3), chain (e.g. Ethereum, Base), earning (true/false — v3 collateral earns none), 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":1153780222.65,"market_count":119},"source":"DeFiLlama open API (yields.llama.fi + api.llama.fi), live","service":"compound-api","endpoints":{"GET /v1/tvl":"Compound TVL total and per-chain breakdown.","GET /v1/fees":"Compound protocol fees (24h/7d/30d).","GET /v1/meta":"This document.","GET /v1/markets":"Per-asset Compound v2/v3 markets with supply APY, TVL and earns_yield (version, chain, earning, sort).","GET /v1/overview":"Combined Compound snapshot (TVL + fees + market count + top market)."},"description":"Live protocol metrics for Compound Finance, one of the original decentralized lending protocols, keyless. Total value locked across every chain, the per-asset markets across Compound v2 and v3 (Comet) with supply APY and TVL — including the v3 distinction where collateral assets do not earn yield — and protocol fees. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The Compound-metrics layer for DeFi dashboards, lending, yield and risk apps. Distinct from other lending protocols — Compound's own markets, v2 + v3, multi-chain.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:30.724Z","request_id":"7b3e28ef-4b92-42a1-81fe-6debb214ef5c"},"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":3500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":2200,"monthly_call_quota":95000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":7200,"monthly_call_quota":650000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":21400,"monthly_call_quota":4800000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/compound-api"}