{"openapi":"3.1.0","info":{"title":"Fluid Protocol API","version":"1.0.0","description":"Live protocol metrics for Fluid (by Instadapp), the hybrid DeFi protocol that combines a lending money-market AND a DEX in one capital-efficient system (smart collateral / smart debt), keyless. Get the total value locked, the DEX trading volume, protocol fees, and the positions across all three Fluid products — the DEX, the lending markets and Fluid Lite (vaults) — each with TVL and supply APY. One combined overview endpoint snapshots it all. Live, nothing stored. The Fluid-metrics layer for DeFi dashboards, lending, DEX, yield and risk apps — distinct from pure DEX, pure lending and generic TVL browsers, this is Fluid hybrid lending-plus-DEX model specifically.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fluid-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 Fluid snapshot (TVL + DEX volume + fees + TVL by product + top pool)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Snapshot of Fluid's hybrid model: total TVL, DEX volume, fees and the largest position.","source":"DeFiLlama","fees_30d":3840872,"protocol":"Fluid","top_pool":{"tvl":128104333,"chain":"Ethereum","symbol":"WSTETH","pool_id":"69b12bf9-edb6-46d9-b5bc-761cf9efe137","product":"lending","total_apy":0.05,"stablecoin":false,"supply_apy":0.05},"total_tvl":954646375.25,"pool_count":188,"chain_count":5,"dex_volume_24h":56066949,"tvl_by_product_top100":{"dex":250561918,"lite":152814606,"lending":935920140}},"meta":{"timestamp":"2026-06-14T08:04:25.371Z","request_id":"4e811c78-6256-4e1d-90ef-3a056ef2f9fa"},"status":"ok","message":"Fluid 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/dex":{"get":{"operationId":"get_v1_dex","tags":["Metrics"],"summary":"Fluid DEX trading volume and protocol fees (24h/7d/30d)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Fluid's DEX trading volume and the protocol's fees, in USD.","source":"DeFiLlama","fees_7d":846521,"fees_24h":92874,"fees_30d":3840872,"protocol":"Fluid","dex_volume_7d":1063982838,"dex_volume_24h":56066949,"dex_volume_30d":5285499517,"dex_volume_all_time":225505511809},"meta":{"timestamp":"2026-06-14T08:04:25.455Z","request_id":"d5c0e602-c27d-4caa-846d-5243a48df9f3"},"status":"ok","message":"Fluid DEX metrics 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":"Fluid TVL total and per-chain breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Total value locked across Fluid's lending, DEX and Lite products, in USD.","chains":[{"tvl":458763911,"chain":"Ethereum"},{"tvl":113238325,"chain":"Arbitrum"},{"tvl":112131814,"chain":"Plasma"},{"tvl":19539805,"chain":"Base"},{"tvl":3350253,"chain":"Polygon"}],"source":"DeFiLlama","protocol":"Fluid","total_tvl":954646375.25,"chain_count":5},"meta":{"timestamp":"2026-06-14T08:04:25.543Z","request_id":"2bf2b5e5-ccd7-4904-8835-cf3debc57ae9"},"status":"ok","message":"Fluid 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/pools":{"get":{"operationId":"get_v1_pools","tags":["Pools"],"summary":"Positions across Fluid dex / lending / lite products with TVL and APY","description":"","parameters":[{"name":"product","in":"query","required":false,"description":"Fluid product: dex, lending or lite","schema":{"type":"string"},"example":"lending"},{"name":"chain","in":"query","required":false,"description":"Filter by chain (e.g. Ethereum, Arbitrum, Base)","schema":{"type":"string"},"example":"Ethereum"},{"name":"min_tvl","in":"query","required":false,"description":"Minimum position 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 supply_apy","schema":{"type":"string"},"example":"tvl"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Positions across all three Fluid products: dex (trading pools), lending (money markets) and lite (vaults).","sort":"tvl","chain":"Ethereum","count":25,"pools":[{"tvl":128104333,"chain":"Ethereum","symbol":"WSTETH","pool_id":"69b12bf9-edb6-46d9-b5bc-761cf9efe137","product":"lending","total_apy":0.05,"stablecoin":false,"supply_apy":0.05},{"tvl":107740408,"chain":"Ethereum","symbol":"USDT","pool_id":"4e8cc592-c8d5-4824-8155-128ba521e903","product":"lending","total_apy":4.43,"reward_apy":1.19,"stablecoin":true,"supply_apy":3.24},{"tvl":105946265,"chain":"Ethereum","symbol":"USDC","pool_id":"4438dabc-7f0c-430b-8136-2722711ae663","product":"lending","total_apy":5.31,"reward_apy":1.21,"stablecoin":true,"supply_apy":4.1},{"tvl":68708028,"chain":"Ethereum","symbol":"ETH","pool_id":"cbb9fc26-2b9e-436a-95d0-c75e2c0f5869","product":"lending","total_apy":1.55,"stablecoin":false,"supply_apy":1.55},{"tvl":33767561,"chain":"Ethereum","symbol":"ETH","pool_id":"1262521f-3ba5-47d7-b035-ace072a0d0df","product":"lending","total_apy":1.55,"stablecoin":false,"supply_apy":1.55},{"tvl":23086822,"chain":"Ethereum","symbol":"WBTC","pool_id":"946c7197-7b0b-438b-a3a0-6de4288c534a","product":"lending","total_apy":0.13,"stablecoin":false,"supply_apy":0.13},{"tvl":15323614,"chain":"Ethereum","symbol":"REUSD","pool_id":"b8324a02-07e1-44ff-bb55-9d55ca98160e","product":"lending","total_apy":0,"stablecoin":true,"supply_apy":0},{"tvl":13173497,"chain":"Ethereum","symbol":"GHO","pool_id":"578cffd4-1470-44d0-8c5d-e9d4bd403651","product":"lending","total_apy":5.52,"reward_apy":2.65,"stablecoin":true,"supply_apy":2.87},{"tvl":12378043,"chain":"Ethereum","symbol":"WBTC","pool_id":"7c4da504-8972-466c-8b74-57132d939dc9","product":"lending","total_apy":0.13,"stablecoin":false,"supply_apy":0.13},{"tvl":11873032,"chain":"Ethereum","symbol":"REUSD","pool_id":"ebce2d4c-2f87-43d2-b989-e1835341ca0d","product":"lending","total_apy":0,"stablecoin":true,"supply_apy":0},{"tvl":8519948,"chain":"Ethereum","symbol":"USDC","pool_id":"db446cb6-2ec5-4fdd-9812-bdbeab125a31","product":"lending","total_apy":4.1,"stablecoin":true,"supply_apy":4.1},{"tvl":6037538,"chain":"Ethereum","symbol":"WSTETH","pool_id":"e278d5a4-b0b5-43d5-8064-c65a3f386b8a","product":"lending","total_apy":0.05,"stablecoin":false,"supply_apy":0.05},{"tvl":5127946,"chain":"Ethereum","symbol":"CBBTC","pool_id":"671ce3a4-6cb1-449c-b784-d54e16006766","product":"lending","total_apy":0.07,"stablecoin":false,"supply_apy":0.07},{"tvl":4938591,"chain":"Ethereum","symbol":"WEETH","pool_id":"5554eb0a-d66e-4878-af40-9c53c3dbb4e0","product":"lending","total_apy":0,"stablecoin":false,"supply_apy":0},{"tvl":4237363,"chain":"Ethereum","symbol":"CBBTC","pool_id":"349a0544-13a1-42bd-84dc-8b54a2b5b7ea","product":"lending","total_apy":0.07,"stablecoin":false,"supply_apy":0.07},{"tvl":2752825,"chain":"Ethereum","symbol":"WETH","pool_id":"82da3bb0-00b6-4d88-b720-8435a3affd48","product":"lending","total_apy":1.55,"stablecoin":false,"supply_apy":1.55},{"tvl":2743529,"chain":"Ethereum","symbol":"WSTETH","pool_id":"c2881fc1-3a80-4fd5-9281-25898924b372","product":"lending","total_apy":0.05,"stablecoin":false,"supply_apy":0.05},{"tvl":2292148,"chain":"Ethereum","symbol":"WEETHS","pool_id":"b6b9796f-d033-4582-8fbe-23902dcba331","product":"lending","total_apy":0,"stablecoin":false,"supply_apy":0},{"tvl":2000171,"chain":"Ethereum","symbol":"USDTB","pool_id":"de1e601d-d589-4a66-91b7-d4ac8bdcecac","product":"lending","total_apy":5.81,"reward_apy":3.4,"stablecoin":true,"supply_apy":2.41},{"tvl":1913549,"chain":"Ethereum","symbol":"WSTUSR","pool_id":"14fc9ec8-7d9f-45a8-9084-78015a5c1a61","product":"lending","total_apy":0,"stablecoin":false,"supply_apy":0},{"tvl":1796631,"chain":"Ethereum","symbol":"PAXG","pool_id":"c1442958-9db9-45c1-a860-912dfc30fc21","product":"lending","total_apy":0,"stablecoin":false,"supply_apy":0},{"tvl":1542677,"chain":"Ethereum","symbol":"SUSDE","pool_id":"8ce99629-db2a-49ef-8fa0-f57e4777de79","product":"lending","total_apy":0,"stablecoin":true,"supply_apy":0},{"tvl":1491725,"chain":"Ethereum","symbol":"WEETH","pool_id":"2c954568-517d-46a1-90f7-dd0dcfce0368","product":"lending","total_apy":0,"stablecoin":false,"supply_apy":0},{"tvl":1390758,"chain":"Ethereum","symbol":"WBTC","pool_id":"bc515a8f-cc93-4833-8556-0cf534cd347e","product":"lending","total_apy":0.13,"stablecoin":false,"supply_apy":0.13},{"tvl":1301938,"chain":"Ethereum","symbol":"WSTETH","pool_id":"1114f0c0-a493-4fed-97bb-922a7138a75a","product":"lending","total_apy":0.05,"stablecoin":false,"supply_apy":0.05}],"source":"DeFiLlama","matched":29,"product":"lending","protocol":"Fluid"},"meta":{"timestamp":"2026-06-14T08:04:25.647Z","request_id":"85fa60b5-f40f-436d-ac7c-c8e5d490a068"},"status":"ok","message":"Fluid 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 product (dex, lending or lite), chain (e.g. Ethereum, Arbitrum, Base), min_tvl, limit (1-100) and sort (tvl, apy or supply_apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.","sample":{"total_tvl":954646375.25,"dex_volume_24h":56066949},"source":"DeFiLlama open API (api.llama.fi + yields.llama.fi), live","service":"fluid-api","endpoints":{"GET /v1/dex":"Fluid's DEX trading volume and protocol fees (24h/7d/30d).","GET /v1/tvl":"Fluid TVL total and per-chain breakdown.","GET /v1/meta":"This document.","GET /v1/pools":"Positions across Fluid's dex / lending / lite products with TVL and APY (product, chain, sort).","GET /v1/overview":"Combined Fluid snapshot (TVL + DEX volume + fees + TVL by product + top pool)."},"description":"Live protocol metrics for Fluid (by Instadapp), the hybrid DeFi protocol combining a lending money-market AND a DEX in one capital-efficient system, keyless. Total value locked, DEX trading volume, protocol fees, and the positions across all three Fluid products — the DEX, the lending markets and Fluid Lite (vaults) — each with TVL and supply APY. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The Fluid-metrics layer for DeFi dashboards, lending, DEX, yield and risk apps. Distinct from pure DEX, pure lending and generic TVL browsers — Fluid's hybrid lending-plus-DEX model specifically.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:25.740Z","request_id":"52a7d0cd-b249-46ff-bf70-2b763a2ca687"},"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":3300,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1950,"monthly_call_quota":88000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":6450,"monthly_call_quota":600000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":19600,"monthly_call_quota":3900000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fluid-api"}