📊Whitelabel TVL & APR

Display real-time TVL (Total Value Locked) and APR (Annual Percentage Rate) on your custom incentives hub. Fuul automatically calculates and refreshes these metrics for programs built on lending, liquidity, and staking protocols.

How it works

Fuul computes TVL and APR at the conversion level for pool-based incentive programs:

• TVL — total value currently locked in the underlying protocol pool, denominated in USD

• APR — estimated annualized return based on the configured reward rate and current TVL

Metrics are automatically refreshed every ~3 hours for active pool incentives.

Fetching TVL & APR

Use the public incentives endpoint — no API key required (API reference):

// GET /v1/incentives?protocol=your-protocol-code

The response includes TVL and APR per conversion:

{
  "conversions": [
    {
      "name": "Deposit USDC",
      "tvl": "12500000.00",
      "apr": "0.145",
      "liquidity_pool_protocol": {
        "code": "morpho-vaults",
        "name": "Morpho Vaults"
      }
    }
  ]
}

Display apr as a percentage (e.g., 0.145 → 14.5% APR).

Protocol support

Protocol type	TVL source
Uniswap V3 and V3-style DEXs	Subgraph query
Lending pools (Morpho, Compound, etc.)	totalSupply() contract call
Morpho Vaults	Subgraph query
Euler V2 looping	Subgraph query

Use cases

• Show depositors the current APR next to each incentive

• Display protocol TVL to signal liquidity depth and program health

• Build comparison tables of multiple active incentives with their live rates

APR is calculated based on the reward rate configured in your program divided by the current TVL. It updates automatically as TVL changes — no manual refresh needed.