Estimación del APR en CLMM

​

La fórmula principal

apr_24h = (fees_24h / tvl_in_range_24h) · 365

• fees_24h es la suma de comisiones de swap del lado de LP acumuladas en las últimas 24 horas (en USD).
• tvl_in_range_24h es el valor USD promedio ponderado en tiempo de la liquidez que estuvo dentro del rango durante la ventana.

​

Cuál será tu APR real

your_APR = headline_APR
         · (your_in_range_fraction / pool_in_range_fraction)     # bonificación de concentración
         · time_in_range                                          # disciplina de rango
         · (1 − transfer_fee_haircut)                             # impuesto Token-2022
         · compounding_factor                                     # si reinviertes automáticamente

• Bonificación de concentración. Si tu rango es más estrecho que el promedio del pool, cada tick activo tiene más de tu liquidez por dólar que la del LP promedio. Más estrecho = bonificación mayor (y amplificación de IL proporcionalmente mayor).
• Tiempo dentro del rango. Si estás dentro del rango solo el 40% del tiempo, multiplica por 0,40.
• Descuento por comisión de transferencia. Para mints Token-2022 con comisiones de transferencia, cada recolección de comisiones pasa por una transferencia que también consume puntos base.
• Capitalización. Si ejecutas collectFee y redepliegas en el mismo rango semanalmente, el APR efectivo es aproximadamente (1 + daily_APR)^365 − 1. Sin capitalización es lineal.

​

Ejemplo práctico

• Volumen 24h: $120M
• Nivel de comisión: 0,05% (LP recibe 84% de las comisiones — cada AmmConfig de CLMM en mainnet tiene protocol_fee_rate = 12% más fund_fee_rate = 4%)
• TVL total: $40M
• TVL dentro del rango: $18M (45% del pool está actualmente dentro del rango)

fees_24h = 120M · 0.0005 · 0.84 = $50,400
apr_24h  = (50,400 / 18,000,000) · 365 = 102%

• Tu rango: lo suficientemente estrecho para que tengas 2× la concentración promedio.
• Tiempo esperado dentro del rango: 70% (revisarás semanalmente).
• Sin comisiones Token-2022. Sin capitalización automática.

your_APR ≈ 102% · 2 · 0.70 = 143%

​

Por qué el APR histórico es una señal rezagada

• Un movimiento de precio grande empuja porciones de posiciones fuera del rango, reduciendo el denominador. De repente tu TVL restante dentro del rango se ve con “APR más alto” — pero solo porque los competidores se fueron, y típicamente el volumen también cae.
• Un pool alcanzando un nuevo máximo histórico puede mostrar temporalmente 500–1000% APR durante una hora ya que la mayoría de posiciones fueron calibradas para precios más bajos y solo algunos LPs agresivos permanecen dentro del rango.
• Una vez que el mercado se estabiliza, los LPs reequilibran y el APR vuelve a la media.

• Ignora APR sub-24h. Demasiado ruido.
• Prefiere ventanas de 7d y 30d. Raydium expone ambas a través de GET /pools/info/ids — campos week.apr y month.apr.
• Prueba retrospectivamente tu rango específico en datos históricos de volumen y precio antes de comprometer capital significativo.

​

Cómo funciona la matemática (paso de un tick)

fees_earned_X = Lₚ · (fee_growth_inside_X(i_lo, i_hi, now) − fee_growth_inside_X(i_lo, i_hi, t_open))
fees_earned_Y = Lₚ · (fee_growth_inside_Y(i_lo, i_hi, now) − fee_growth_inside_Y(i_lo, i_hi, t_open))

expected_fees_per_day = Σ_ticks_in_range (volume_at_tick · fee_rate · your_share_at_tick)

​

Ayudante del SDK

import { Raydium, PoolUtils } from "@raydium-io/raydium-sdk-v2";

const raydium = await Raydium.load({ owner, connection });
// getPoolInfoFromRpc toma una cadena base58 posicional en el módulo CLMM.
const pool = await raydium.clmm.getPoolInfoFromRpc(POOL_ID);

// Síncrono, y lee las estadísticas de volumen/comisión de poolInfo[aprType].
const apr = PoolUtils.estimateAprsForPriceRangeMultiplier({
  poolInfo: pool.poolInfo,
  aprType: "day",                 // "day" | "week" | "month"
  positionTickLowerIndex: -100,   // tu rango previsto
  positionTickUpperIndex:  100,
});

console.log(`Expected APR: ${apr.feeApr}% fee-only; rewards: ${apr.rewardsApr.join(", ")}`);

​

Dónde encaja el APR de farm

Total APR = Fee APR + Farm APR [en mints de recompensa $X, Y, Z]

​

Errores comunes

• “El APR se capitaliza automáticamente.” No. Las comisiones deben reclamarse — a través de un DecreaseLiquidity de liquidez cero, ya que CLMM no tiene instrucción de recolección independiente — y luego redesplegarse manualmente. Raydium no capitaliza automáticamente las comisiones de CLMM.
• “Mi APR = APR principal.” Solo si tu concentración es promedio, tu tiempo dentro del rango es 100%, y capitalizas al mismo ritmo. Los tres suelen ser falsos.
• “Nivel de comisión más alto = APR más alto.” Solo si el volumen sobrevive a la comisión más alta. Al 1% un par puede cotizar 50% APR pero hacer 1/10 del volumen; neto menos que 0,25% al 120% × 0,1 = 12%.
• “Las posiciones fuera del rango tienen cero riesgo.” Tienen cero ingresos por comisiones pero IL completo en la composición de tokens existente — la posición es ahora “100% de cualquier lado”.

​

Referencias

• algorithms/clmm-math — derivación completa del acumulador de crecimiento de comisiones.
• algorithms/impermanent-loss — el lado de pérdida de la ecuación de LP.
• user-flows/choosing-a-pool-type — marco de decisión que usa esta estimación de APR.
• sdk-api/rest-api — puntos finales de volumen / APR en vivo.

• Implementaciones de Raydium SDK v2 PoolUtils.estimateAprsForPriceRangeMultiplier / estimateAprsForPriceRangeDelta.
• Página de pool de la interfaz de Raydium (campos de APR en vivo).
• Derivación de crecimiento de comisiones de Uniswap V3.