{"openapi":"3.1.0","info":{"title":"Liquity Protocol API","version":"1.0.0","description":"Live protocol metrics for Liquity, the original immutable decentralized borrowing protocol that issues the LUSD and BOLD stablecoins against ETH and liquid-staking-token collateral, keyless. Get the total collateral locked, the breakdown of which assets back the stablecoins (ETH, wstETH, rETH across Liquity v1 + v2), per-chain TVL, and the Liquity pools (stability pools / earning positions) with their APY. One combined overview endpoint snapshots it all. Live, nothing stored. The CDP / decentralized-stablecoin metrics layer for DeFi dashboards, stablecoin, risk and yield apps — distinct from DEX, lending, restaking and yield protocols, this is Liquity collateralized-debt model specifically.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/liquity-api","description":"oanor gateway"}],"tags":[{"name":"Overview"},{"name":"Metrics"},{"name":"Collateral"},{"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 Liquity snapshot (collateral + assets + best pool)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Snapshot of Liquity: total collateral, the assets backing LUSD/BOLD, and the best-earning pool.","source":"DeFiLlama","protocol":"Liquity","best_pool":{"apy":2.75,"symbol":"BOLD","version":"v2"},"pool_count":7,"chain_count":1,"top_collateral":{"usd":137995829.3,"asset":"WETH","share_pct":69.78},"total_collateral_usd":197759953.66,"collateral_asset_count":3},"meta":{"timestamp":"2026-06-14T08:04:28.949Z","request_id":"966d90c2-1025-404b-b6d2-23e95d66b103"},"status":"ok","message":"Liquity 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/tvl":{"get":{"operationId":"get_v1_tvl","tags":["Metrics"],"summary":"Total collateral locked in Liquity (total + per-chain)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Total collateral locked in Liquity backing the LUSD / BOLD stablecoins, in USD.","chains":[{"tvl":197759952,"chain":"Ethereum"}],"source":"DeFiLlama","protocol":"Liquity","chain_count":1,"total_collateral_usd":197759953.66},"meta":{"timestamp":"2026-06-14T08:04:29.012Z","request_id":"a4a72e6d-0ee6-438c-8634-935f546a0777"},"status":"ok","message":"Liquity 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/collateral":{"get":{"operationId":"get_v1_collateral","tags":["Collateral"],"summary":"Assets backing LUSD/BOLD — ETH and LSTs, by USD and share","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 25)","schema":{"type":"string"},"example":"25"},{"name":"min_usd","in":"query","required":false,"description":"Minimum asset value in USD","schema":{"type":"string"},"example":"1000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Assets backing Liquity's LUSD / BOLD stablecoins (ETH and liquid-staking tokens), by USD value and share.","count":3,"source":"DeFiLlama","protocol":"Liquity","collateral":[{"usd":137995829.3,"asset":"WETH","share_pct":69.78},{"usd":47895287.5,"asset":"WSTETH","share_pct":24.22},{"usd":11868836.86,"asset":"RETH","share_pct":6}],"asset_count":3},"meta":{"timestamp":"2026-06-14T08:04:29.074Z","request_id":"1c7e0ba3-368c-4f0e-8676-ce1c8d79c7c7"},"status":"ok","message":"Liquity collateral 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":"Liquity pools (stability pools / deposits) with APY","description":"","parameters":[{"name":"version","in":"query","required":false,"description":"Liquity version: v1 or v2","schema":{"type":"string"},"example":"v2"},{"name":"earning","in":"query","required":false,"description":"Only pools that earn yield (true/false)","schema":{"type":"string"},"example":"true"},{"name":"sort","in":"query","required":false,"description":"Sort by tvl or apy","schema":{"type":"string"},"example":"apy"},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Liquity pools — stability pools and deposit positions across v1 and v2; the BOLD stability pool earns yield.","sort":"apy","count":3,"pools":[{"apy":2.75,"tvl":2596967,"chain":"Ethereum","symbol":"BOLD","pool_id":"326739f2-4650-4992-a8eb-a400e7790499","version":"v2","stablecoin":true},{"apy":1.78,"tvl":10281955,"chain":"Ethereum","symbol":"BOLD","pool_id":"dac71f4f-7b97-463a-b19f-9796c56c21f1","version":"v2","stablecoin":true},{"apy":1.77,"tvl":6859447,"chain":"Ethereum","symbol":"BOLD","pool_id":"a635df9a-4cfc-4d17-86d0-934ea441e79f","version":"v2","stablecoin":true}],"source":"DeFiLlama","matched":3,"version":"v2","protocol":"Liquity"},"meta":{"timestamp":"2026-06-14T08:04:29.159Z","request_id":"622d4e09-8c4b-4324-8ed9-b7f456cce9c0"},"status":"ok","message":"Liquity 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":"collateral takes optional limit (1-100) and min_usd. pools takes optional version (v1, v2), earning (true/false) and sort (tvl or apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.","sample":{"top_collateral":"WETH","total_collateral_usd":197759953.66},"source":"DeFiLlama open API (api.llama.fi + yields.llama.fi), live","service":"liquity-api","endpoints":{"GET /v1/tvl":"Total collateral locked in Liquity (total + per-chain).","GET /v1/meta":"This document.","GET /v1/pools":"Liquity pools (stability pools / deposits) with APY (version, earning, sort).","GET /v1/overview":"Combined Liquity snapshot (collateral + assets + best pool).","GET /v1/collateral":"Assets backing LUSD/BOLD — ETH and LSTs, by USD and share."},"description":"Live protocol metrics for Liquity, the original immutable decentralized borrowing protocol issuing the LUSD and BOLD stablecoins against ETH and LST collateral, keyless. Total collateral locked, the breakdown of which assets back the stablecoins (ETH, wstETH, rETH across v1 + v2), per-chain TVL, and the Liquity pools (stability pools) with APY. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The CDP / decentralized-stablecoin metrics layer for DeFi dashboards, stablecoin, risk and yield apps. Distinct from DEX, lending, restaking and yield protocols — Liquity's collateralized-debt model specifically.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:29.242Z","request_id":"72710370-2a61-4638-9d3b-1ccc77df942b"},"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":2300,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1400,"monthly_call_quota":58000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4700,"monthly_call_quota":360000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":14400,"monthly_call_quota":2400000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/liquity-api"}