{"openapi":"3.1.0","info":{"title":"Convex Finance API","version":"1.0.0","description":"Live protocol metrics for Convex Finance, the yield-booster built on top of Curve (it lets liquidity providers and CRV holders earn boosted rewards), keyless. Get the total value locked, the boosted Curve yield pools with their TVL and APY (base + rewards), per-chain TVL, and protocol fees and revenue. One combined overview endpoint snapshots it all. Live, nothing stored. The yield-aggregator metrics layer for DeFi dashboards, yield, farming and analytics apps — distinct from DEX, lending, restaking and generic DeFi/TVL browsers, this is Convex Curve-boosted yield specifically.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/convex-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 Convex snapshot (TVL + pools + fees + revenue + top pool)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Snapshot of Convex Finance: TVL, boosted-pool count, fees, revenue and the largest pool.","source":"DeFiLlama","fees_24h":9964,"protocol":"Convex Finance","top_pool":{"apy":2.24,"tvl":49739778,"chain":"Ethereum","symbol":"FRAX-USDE","pool_id":"5fac4a47-5360-49b7-8b61-66f88a3d939f","apy_base":0.02,"apy_reward":2.22,"stablecoin":true,"apy_30d_avg":1.91,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},"total_tvl":522132432.9,"pool_count":196,"chain_count":4,"revenue_24h":9085,"revenue_30d":715237},"meta":{"timestamp":"2026-06-14T08:04:33.058Z","request_id":"36789db8-9f9e-4b36-b041-a899f0c6db1c"},"status":"ok","message":"Convex 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":"Convex protocol fees and revenue (24h/7d/30d)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Fees = total paid by users; revenue = the share kept by the Convex protocol. USD.","source":"DeFiLlama","fees_7d":262752,"fees_24h":9964,"fees_30d":723855,"protocol":"Convex Finance","revenue_7d":261120,"revenue_24h":9085,"revenue_30d":715237},"meta":{"timestamp":"2026-06-14T08:04:33.137Z","request_id":"3f51673d-986f-4cdb-af85-e7d8f4ac3bd1"},"status":"ok","message":"Convex 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":"Convex TVL total and per-chain breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Total value locked in Convex (boosted Curve positions), in USD.","chains":[{"tvl":513789170.05,"chain":"Ethereum"},{"tvl":6312506.16,"chain":"Fraxtal"},{"tvl":1805067.79,"chain":"Arbitrum"},{"tvl":225688.9,"chain":"Polygon"}],"source":"DeFiLlama","protocol":"Convex Finance","total_tvl":522132432.9,"chain_count":4},"meta":{"timestamp":"2026-06-14T08:04:33.213Z","request_id":"441c4ca6-7b7d-4457-8c94-77754cf0251b"},"status":"ok","message":"Convex 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":"Boosted Curve yield pools on Convex with base and reward APY","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Filter by chain (e.g. Ethereum, Arbitrum)","schema":{"type":"string"},"example":"Ethereum"},{"name":"stablecoin","in":"query","required":false,"description":"Only stablecoin pools (true/false)","schema":{"type":"string"},"example":"true"},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 25)","schema":{"type":"string"},"example":"25"},{"name":"min_tvl","in":"query","required":false,"description":"Minimum pool TVL in USD","schema":{"type":"string"},"example":"1000000"},{"name":"sort","in":"query","required":false,"description":"Sort by tvl or apy","schema":{"type":"string"},"example":"tvl"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Boosted Curve yield pools on Convex, with base and reward APY.","sort":"tvl","chain":"Ethereum","count":25,"pools":[{"apy":2.24,"tvl":49739778,"chain":"Ethereum","symbol":"FRAX-USDE","pool_id":"5fac4a47-5360-49b7-8b61-66f88a3d939f","apy_base":0.02,"apy_reward":2.22,"stablecoin":true,"apy_30d_avg":1.91,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":5.22,"tvl":41405558,"chain":"Ethereum","symbol":"DOLA-SUSDE","pool_id":"85407c01-6f16-4cef-9ef2-1b2bf2556183","apy_base":0.78,"apy_reward":4.44,"stablecoin":true,"apy_30d_avg":2.98,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b","0xA153B9dFE150098cFeAfb9288f3657D09fC39663"]},{"apy":0.02,"tvl":19296855,"chain":"Ethereum","symbol":"USDC-RLUSD","pool_id":"d826a92b-2bd2-4fae-8483-db1ef8888aee","apy_base":0.02,"apy_reward":0,"stablecoin":true,"apy_30d_avg":0.33,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b","0x75A66958919f47870f62b2780c34a235dC357586"]},{"apy":2.73,"tvl":17375674,"chain":"Ethereum","symbol":"CRVUSD","pool_id":"027b72c2-bf96-451b-ac5f-afe6859b0828","apy_base":1.6,"apy_reward":1.13,"stablecoin":true,"apy_30d_avg":2.33,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":5.33,"tvl":12559713,"chain":"Ethereum","symbol":"USDC-CRVUSD","pool_id":"755fcec6-f4fd-4150-9184-60f099206694","apy_base":0.16,"apy_reward":5.17,"stablecoin":true,"apy_30d_avg":5.11,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":2.79,"tvl":11808740,"chain":"Ethereum","symbol":"SFRXUSD-FRXUSD","pool_id":"956bda67-d4b0-41bf-92da-ea01f4622dda","apy_base":1.67,"apy_reward":1.12,"stablecoin":true,"apy_30d_avg":2.12,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":5.71,"tvl":11108930,"chain":"Ethereum","symbol":"USDT-CRVUSD","pool_id":"a3ffd3fe-b21c-44eb-94d5-22c80057a600","apy_base":0.02,"apy_reward":5.69,"stablecoin":true,"apy_30d_avg":5.7,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":6.04,"tvl":9555544,"chain":"Ethereum","symbol":"FRXUSD-CRVUSD","pool_id":"22a20de7-791a-48f2-8765-537db17b7f9e","apy_base":0.09,"apy_reward":5.95,"stablecoin":true,"apy_30d_avg":5.56,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":2.69,"tvl":8965523,"chain":"Ethereum","symbol":"CRVUSD","pool_id":"eb0af544-1cc0-4617-8187-218fef3a24f9","apy_base":0.48,"apy_reward":2.21,"stablecoin":true,"apy_30d_avg":2.1,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":0.05,"tvl":8066266,"chain":"Ethereum","symbol":"USDC-FXUSD","pool_id":"769acc2d-bbc7-4242-87fd-98fcc015f21e","apy_base":0.05,"apy_reward":0,"stablecoin":true,"apy_30d_avg":0.75,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":11.57,"tvl":7934694,"chain":"Ethereum","symbol":"FRXUSD-MSUSD","pool_id":"ee024c35-c5c3-4a41-9018-75f72ec7ae4a","apy_base":0.13,"apy_reward":11.44,"stablecoin":true,"apy_30d_avg":11.23,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":0.03,"tvl":7781199,"chain":"Ethereum","symbol":"PYUSD-USDC","pool_id":"01146cce-9140-4e03-9a2e-82c99ccc42f1","apy_base":0.03,"apy_reward":0,"stablecoin":true,"apy_30d_avg":0.23,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b","0x85D81Ee851D36423A5784CD3Cb6f1a1193Cb5978"]},{"apy":2.24,"tvl":5759605,"chain":"Ethereum","symbol":"FRXUSD-USPC","pool_id":"ff64e4a9-161d-42b8-82a3-b9436c6ceeb1","apy_base":0.01,"apy_reward":2.23,"stablecoin":true,"apy_30d_avg":7.07,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":5.02,"tvl":5565451,"chain":"Ethereum","symbol":"DOLA-SUSDS","pool_id":"51f9c038-feed-4666-8866-30efc92e0566","apy_base":0.8,"apy_reward":4.22,"stablecoin":true,"apy_30d_avg":3.69,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":12.91,"tvl":5378113,"chain":"Ethereum","symbol":"MIM-3CRV","pool_id":"8a20c472-142c-4442-b724-40f2183c073e","apy_base":0.14,"apy_reward":12.77,"stablecoin":true,"apy_30d_avg":9.35,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":7.64,"tvl":4784749,"chain":"Ethereum","symbol":"REUSD-SCRVUSD","pool_id":"1971c939-46e4-4b86-87d9-78308de47af7","apy_base":1.42,"apy_reward":6.22,"stablecoin":true,"apy_30d_avg":8.37,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":0.2,"tvl":4515483,"chain":"Ethereum","symbol":"USDC-EURS","pool_id":"efa8dc4f-03df-4633-95bf-db188292d9a3","apy_base":0.02,"apy_reward":0.18,"stablecoin":true,"apy_30d_avg":0.28,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":0.59,"tvl":4020452,"chain":"Ethereum","symbol":"CRVUSD","pool_id":"0359418f-fedd-4973-9221-957a11c0a692","apy_base":0.59,"apy_reward":0,"stablecoin":true,"apy_30d_avg":1.49,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":12.26,"tvl":3861053,"chain":"Ethereum","symbol":"MSUSD-FRAXBP","pool_id":"5b0d9168-00ca-4326-bdd5-04eed0e9b4a7","apy_base":0.22,"apy_reward":12.04,"stablecoin":true,"apy_30d_avg":11.27,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":6.69,"tvl":3836613,"chain":"Ethereum","symbol":"ALUSD-FRXUSD","pool_id":"398fc5e7-b9e3-45a2-b9bb-e65913bb02a6","apy_base":0.12,"apy_reward":6.57,"stablecoin":true,"apy_30d_avg":6.48,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":2.04,"tvl":1942524,"chain":"Ethereum","symbol":"CRVUSD","pool_id":"64078a28-4d66-43d7-bc97-012994a0e4d4","apy_base":1.88,"apy_reward":0.16,"stablecoin":true,"apy_30d_avg":2.12,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":22.62,"tvl":1877634,"chain":"Ethereum","symbol":"PMUSD-CRVUSD","pool_id":"b395019b-ecc9-430d-be47-617f13fa3975","apy_base":0.04,"apy_reward":22.58,"stablecoin":true,"apy_30d_avg":18.12,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":8.21,"tvl":1839647,"chain":"Ethereum","symbol":"SDOLA-ALUSD","pool_id":"1fa89639-b77f-4876-bebc-21ba6f36aab1","apy_base":0.97,"apy_reward":7.24,"stablecoin":true,"apy_30d_avg":8.43,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":24.48,"tvl":1689021,"chain":"Ethereum","symbol":"PMUSD-FRXUSD","pool_id":"02ad75ab-b463-465f-a942-1c858ab4fd17","apy_base":0.02,"apy_reward":24.46,"stablecoin":true,"apy_30d_avg":18.9,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]},{"apy":7.18,"tvl":1687141,"chain":"Ethereum","symbol":"USDC-USDF","pool_id":"977bc628-7476-43cf-abb8-68934bf56171","apy_base":0.36,"apy_reward":6.82,"stablecoin":true,"apy_30d_avg":6.81,"reward_tokens":["0xd533a949740bb3306d119cc777fa900ba034cd52","0x4e3fbd56cd56c3e72c1403e103b45db9da5b9d2b"]}],"source":"DeFiLlama","matched":33,"protocol":"Convex Finance"},"meta":{"timestamp":"2026-06-14T08:04:33.307Z","request_id":"e35829aa-5eee-4be6-aefe-4cef25193ec9"},"status":"ok","message":"Convex 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 chain (e.g. Ethereum, Arbitrum), stablecoin (true/false), min_tvl, limit (1-100) and sort (tvl or apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.","sample":{"total_tvl":522132432.9,"revenue_30d":715237},"source":"DeFiLlama open API (api.llama.fi + yields.llama.fi), live","service":"convex-api","endpoints":{"GET /v1/tvl":"Convex TVL total and per-chain breakdown.","GET /v1/fees":"Convex protocol fees and revenue (24h/7d/30d).","GET /v1/meta":"This document.","GET /v1/pools":"Boosted Curve yield pools on Convex with base and reward APY (chain, stablecoin, sort).","GET /v1/overview":"Combined Convex snapshot (TVL + pools + fees + revenue + top pool)."},"description":"Live protocol metrics for Convex Finance, the yield-booster built on top of Curve, keyless. Total value locked, the boosted Curve yield pools with TVL and APY (base + rewards), per-chain TVL, and protocol fees and revenue. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The yield-aggregator metrics layer for DeFi dashboards, yield, farming and analytics apps. Distinct from DEX, lending, restaking and generic DeFi/TVL browsers — Convex's Curve-boosted yield specifically.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:33.381Z","request_id":"a35090ab-0997-4b4a-a89a-20fcec85469e"},"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":2600,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1500,"monthly_call_quota":68000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5100,"monthly_call_quota":440000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":15900,"monthly_call_quota":2700000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/convex-api"}