# Convex Finance API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/convex-api/..." ``` ## Pricing - **Free** (Free) — 2,600 calls/Mo, 3 req/s - **Starter** ($15/Mo) — 68,000 calls/Mo, 8 req/s - **Pro** ($51/Mo) — 440,000 calls/Mo, 20 req/s - **Business** ($159/Mo) — 2,700,000 calls/Mo, 50 req/s ## Endpoints ### Overview #### `GET /v1/overview` — Combined Convex snapshot (TVL + pools + fees + revenue + top pool) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/convex-api/v1/overview" ``` **Response:** ```json { "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 } ``` ### Metrics #### `GET /v1/fees` — Convex protocol fees and revenue (24h/7d/30d) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/convex-api/v1/fees" ``` **Response:** ```json { "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 } ``` #### `GET /v1/tvl` — Convex TVL total and per-chain breakdown **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/convex-api/v1/tvl" ``` **Response:** ```json { "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 } ``` ### Pools #### `GET /v1/pools` — Boosted Curve yield pools on Convex with base and reward APY **Parameters:** - `chain` (query, optional, string) — Filter by chain (e.g. Ethereum, Arbitrum) Example: `Ethereum` - `stablecoin` (query, optional, string) — Only stablecoin pools (true/false) Example: `true` - `limit` (query, optional, string) — Results (1-100, default 25) Example: `25` - `min_tvl` (query, optional, string) — Minimum pool TVL in USD Example: `1000000` - `sort` (query, optional, string) — Sort by tvl or apy Example: `tvl` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/convex-api/v1/pools?chain=Ethereum&stablecoin=true&limit=25&min_tvl=1000000&sort=tvl" ``` **Response:** ```json { "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", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata & live sample **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/convex-api/v1/meta" ``` **Response:** ```json { "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" }, …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/convex-api OpenAPI spec: https://www.oanor.com/api/convex-api/openapi.json