{"openapi":"3.1.0","info":{"title":"Frax Finance Pools & Yield API","version":"1.0.0","description":"Live liquidity-pool and yield data for the Frax Finance ecosystem — the FRAX stablecoin, frxETH and FXS — from the public Frax API, no key, nothing stored. This is the Frax-yield view: every incentivised Frax liquidity pool across every chain and DEX, with its locked liquidity and APY, distinct from the generic DeFi-yield and protocol APIs in the catalogue. The pools endpoint lists Frax pools — optionally filtered by chain or DEX platform — with the trading pair, the pool tokens, the value locked and the base and maximum APY. The pool endpoint returns one pool in full, including the reward breakdown across swap fees and incentive rewards. The summary endpoint aggregates the ecosystem: total value locked, the pool count and the distribution across chains and DEX platforms, plus the highest-yielding pools. Build DeFi yield dashboards, Frax-farming optimisers, APY trackers and treasury tools on top of real Frax Finance data. Filter by chain (ethereum, arbitrum, fraxtal, optimism, polygon and more) or platform (uniswap_v3, curve, convex, balancer); pool APYs are returned as percentages.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/frax-api","description":"oanor gateway"}],"tags":[{"name":"Pools"},{"name":"Pool"},{"name":"Summary"},{"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/pools":{"get":{"operationId":"get_v1_pools","tags":["Pools"],"summary":"Frax pools ranked by liquidity","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Filter by chain (ethereum, fraxtal, arbitrum…)","schema":{"type":"string"},"example":"ethereum"},{"name":"platform","in":"query","required":false,"description":"Filter by DEX platform (curve, uniswap_v3…)","schema":{"type":"string"},"example":"curve"},{"name":"limit","in":"query","required":false,"description":"Max pools (default 50, max 273)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"pools":[{"pair":"Curve FRAX/USDC","chain":"ethereum","tokens":["FRAX","USDC"],"apy_pct":779.1298,"platform":"curve","identifier":"Curve FRAX/USDC","apy_max_pct":1947.8246,"liquidity_locked_usd":5018668.39},{"pair":"Curve FRAX3CRV-f-2","chain":"ethereum","tokens":["FRAX","DAI","USDC","USDT"],"apy_pct":0.0012,"platform":"curve","identifier":"Curve FRAX3CRV-f-2","apy_max_pct":0.003,"liquidity_locked_usd":584721.63}],"source":"Frax Finance","protocol":"Frax Finance"},"meta":{"timestamp":"2026-06-12T01:42:27.923Z","request_id":"d484ebbb-207b-49ad-8760-6cb12aed7e5f"},"status":"ok","message":"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/pool":{"get":{"operationId":"get_v1_pool","tags":["Pool"],"summary":"One pool in full with reward breakdown","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Pool identifier","schema":{"type":"string"},"example":"Uniswap V3 FRAX/USDC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"link":"https://app.frax.finance/staking#Uniswap_V3_FRAX_USDC","pair":"Uniswap V3 FRAX/USDC","chain":"ethereum","source":"Frax Finance","tokens":["FRAX","USDC"],"apy_pct":0.0419,"rewards":[{"name":"Swap Fees","type":"fees","symbol":"SWAP_FEES","apr_max_pct":0,"apr_min_pct":0},{"name":"FXS","type":"tokens","symbol":"FXS","apr_max_pct":0.002093794681544357,"apr_min_pct":0.0004187589363088714}],"platform":"uniswap_v3","protocol":"Frax Finance","identifier":"Uniswap V3 FRAX/USDC","lp_address":"0xC36442b4a4522E871399CD717aBDD847Ab11FE88","apy_max_pct":0.2094,"farm_address":"0x3EF26504dbc8Dd7B7aa3E97Bc9f3813a9FC0B4B0","liquidity_locked_usd":24111772.71},"meta":{"timestamp":"2026-06-12T01:42:28.014Z","request_id":"fd4b2e12-e66c-42d1-b371-f5194d807890"},"status":"ok","message":"Pool 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/summary":{"get":{"operationId":"get_v1_summary","tags":["Summary"],"summary":"Ecosystem aggregate — TVL, chain/platform split","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chains":10,"source":"Frax Finance","protocol":"Frax Finance","platforms":47,"pool_count":273,"tvl_by_chain":{"bsc":14300.9,"fantom":2181682.77,"fraxtal":543965.24,"polygon":99998.53,"arbitrum":513634.24,"ethereum":110575499.26,"moonbeam":11905.31,"optimism":125673.95,"avalanche":986.62,"moonriver":176085.48},"tvl_by_platform":{"fxb":24317.87,"fxs":11656865.66,"aave":0,"aura":0,"fpis":54938.26,"frax":13992496.19,"idex":0,"angle":0,"bunni":994.49,"curve":5603390.02,"thena":0,"yearn":0,"arable":0,"convex":43189458.5,"gelato":32.23,"morpho":889.02,"ramses":0,"saddle":43423.85,"vector":0,"vesper":2439.07,"wombat":14300.9,"apeswap":0,"echidna":0,"gearbox":0,"mstable":99827.79,"tokemak":12553.18,"uniswap":129255.06,"alphadex":0,"balancer":170.71,"moonwell":0,"platypus":0,"stakedao":72620.49,"stargate":9106.93,"kyberswap":8386.1,"sentiment":10089.52,"solarbeam":0,"sommelier":486.3,"sushiswap":197127.68,"templedao":1867.23,"traderjoe":0,"velodrome":121537.93,"spiritswap":2181682.77,"stellaswap":11905.31,"uniswap_v3":36768523.25,"fluxfinance":603.4,"beefy_finance":3002.92,"curve_arbi_vstfrax":31439.67},"top_pools_by_apy":[{"chain":"arbitrum","apy_pct":15583.8417,"platform":"sentiment","identifier":"Sentiment LFrax","liquidity_locked_usd":10089.52},{"chain":"ethereum","apy_pct":2834.7918,"platform":"convex","identifier":"Convex stkcvxALCXFRAXBP","liquidity_locked_usd":334181.89},{"chain":"ethereum","apy_pct":2816.4021,"platform":"convex","identifier":"Convex ALCXFRAXBP","liquidity_locked_usd":357135.93},{"chain":"fantom","apy_pct":2741.6276,"platform":"spiritswap","identifier":"SpiritSwap/Ola FRAX Lending","liquidity_locked_usd":1399539.75},{"chain":"ethereum","apy_pct":1820.8283,"platform":"frax","identifier":"Fraxswap V2 FRAX/pitchFXS","liquidity_locked_usd":40350.46},{"chain":"ethereum","apy_pct":1303.1356,"platform":"convex","identifier":"Convex stkcvxmsUSDFRAXBP","liquidity_locked_usd":1331039.54},{"chain":"ethereum","apy_pct":1274.0761,"platform":"convex","identifier":"Convex msUSDFRAXBP","liquidity_locked_usd":4164822.64},{"chain":"ethereum","apy_pct":883.8514,"platform":"convex","identifier":"Convex stkcvxFRAXBP","liquidity_locked_usd":59312.06},{"chain":"ethereum","apy_pct":816.2473,"platform":"convex","identifier":"Convex FRAX/USDC","liquidity_locked_usd":200707.18},{"chain":"ethereum","apy_pct":779.1298,"platform":"curve","identifier":"Curve FRAX/USDC","liquidity_locked_usd":5018668.39}],"total_value_locked_usd":114243732.24},"meta":{"timestamp":"2026-06-12T01:42:28.105Z","request_id":"00e9ecce-ee5a-4031-b728-898a41d90e7d"},"status":"ok","message":"Summary 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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Filter pools by chain (ethereum, arbitrum, fraxtal, optimism, polygon, bsc, avalanche…) or platform (uniswap_v3, curve, convex, balancer, aave…). A pool is looked up by its identifier, e.g. id=Uniswap V3 FRAX/USDC. APYs are percentages.","source":"Frax Finance public API (api.frax.finance/v1, live)","service":"frax-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/pool":"One pool in full with reward breakdown (id=Uniswap V3 FRAX/USDC).","GET /v1/pools":"Frax pools ranked by liquidity (chain=ethereum, platform=curve, limit=50 — all optional).","GET /v1/summary":"Ecosystem aggregate — TVL, pool count, chain/platform split, top APY pools."},"description":"Live liquidity-pool and yield data for the Frax Finance ecosystem (the FRAX stablecoin, frxETH and FXS) from the public Frax API. The Frax-yield view — every incentivised Frax liquidity pool across every chain and DEX, with its locked liquidity and APY. pools = the list of Frax pools (optionally filtered by chain or platform) with pair, tokens, value locked and base/max APY; pool = one pool in full including the reward breakdown (swap fees and incentive rewards); summary = the ecosystem aggregate (total value locked, pool count, distribution across chains and DEX platforms, highest-yielding pools). Live, no key, nothing stored. Distinct from the generic DeFi-yield and protocol APIs.","pools_tracked":273,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:42:28.189Z","request_id":"6ffac501-2f18-455e-8ed4-06bd3e4f47ba"},"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":13500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":840,"monthly_call_quota":200000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2480,"monthly_call_quota":815000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5560,"monthly_call_quota":2950000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/frax-api"}