Liquidity-provider fee APY calculator API

Compute LP fee APR/APY from daily volume, fee tier and pool share: feeAPR = (volume·feeTier·share/liquidity)·365, APY = (1+APR/n)^n − 1, plus an optional reward APR. Deterministic DeFi yield math with a per-source breakdown. Answers 'what APY does this pool earn','fee APR from volume','LP yield with rewards'.

Price$0.01per request

MethodPOST

Route/v1/calc/cryptocalc-lp-apy

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calccryptodefilpapyyieldfeesliquidity

API URLhttps://x402.hexl.dev/v1/calc/cryptocalc-lp-apy

Integration docs

Example request

{
  "liquidity": 50000,
  "poolTvl": 1000000,
  "dailyVolume": 2000000,
  "feeTier": 0.003,
  "rewardApr": 0.05
}

Example response

{
  "formula": "feeAPR = (volume·feeTier·share/liquidity)·365; APY = (1+APR/n)^n − 1",
  "poolShare": 0.05,
  "dailyFees": 300,
  "feeApr": 2.19,
  "feeAprPct": 219,
  "feeApy": 7.876933,
  "feeApyPct": 787.6933,
  "rewardAprPct": 5,
  "totalAprPct": 224,
  "breakdown": [
    {
      "factor": "fees",
      "aprPct": 219
    },
    {
      "factor": "rewards",
      "aprPct": 5
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "liquidity",
    "dailyVolume",
    "feeTier"
  ],
  "properties": {
    "liquidity": {
      "type": "number",
      "description": "your position size in USD",
      "examples": [
        50000
      ]
    },
    "poolTvl": {
      "type": "number",
      "description": "total pool TVL in USD",
      "examples": [
        1000000
      ]
    },
    "dailyVolume": {
      "type": "number",
      "description": "pool daily volume in USD",
      "examples": [
        2000000
      ]
    },
    "feeTier": {
      "type": "number",
      "description": "decimal fee, e.g. 0.003 for 0.3%",
      "examples": [
        0.003
      ]
    },
    "rewardApr": {
      "type": "number",
      "description": "extra emissions APR (decimal)",
      "examples": [
        0.05
      ]
    },
    "compoundsPerYear": {
      "type": "number",
      "examples": [
        365
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}