Estimation de l'APR CLMM

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →

L’APR affiché sur l’interface Raydium pour un pool CLMM est l’APR de frais réalisé de la liquidité en plage au cours des 24 dernières heures, projeté sur un an. Ce n’est pas l’APR que votre position aurait gagné — cela dépend de votre plage, de votre temps en plage, et de votre part de la liquidité qui était active pendant la fenêtre de trading.

La formule principale

Pour un pool CLMM, l’APR des frais quotidiens affiché sur Raydium est calculé comme suit :

apr_24h = (fees_24h / tvl_in_range_24h) · 365

Où :

fees_24h est la somme des frais de swap côté LP accumulés au cours des 24 dernières heures (en USD).
tvl_in_range_24h est la valeur USD moyenne pondérée dans le temps de la liquidité qui était en plage pendant la fenêtre.

Le dénominateur est ce qui distingue l’APR CLMM de l’APR CPMM. CPMM utilise la TVL totale du pool car chaque dollar contribue toujours. CLMM utilise uniquement le sous-ensemble en plage car les dollars hors plage ne gagnent rien.

Quel sera réellement votre APR

L’APR principal est une statistique du pool, pas de votre position. Votre APR dépend de quatre multiplicateurs :

your_APR = headline_APR
         · (your_in_range_fraction / pool_in_range_fraction)     # bonus de concentration
         · time_in_range                                          # discipline de plage
         · (1 − transfer_fee_haircut)                             # taxe token-2022
         · compounding_factor                                     # si vous réinvestissez automatiquement

Bonus de concentration. Si votre plage est plus étroite que la moyenne du pool, chaque tick actif a plus de votre liquidité par dollar que celle du LP moyen. Plus étroit = bonus plus grand (et amplification IL proportionnellement plus grande).
Temps en plage. Si vous êtes en plage seulement 40 % du temps, multipliez par 0,40.
Déduction de frais de transfert. Pour les mints Token-2022 avec frais de transfert, chaque collecte de frais passe par un transfert qui saigne lui-même des points de base.
Composition. Si vous collectFee et redéployez dans la même plage chaque semaine, l’APR effectif est environ (1 + daily_APR)^365 − 1. Sans composition, c’est linéaire.

Exemple travaillé

Supposons qu’un pool CLMM SOL/USDC ait :

Volume 24h : $120M
Niveau de frais : 0,05 % (part LP 84 % des frais — chaque AmmConfig CLMM du mainnet porte protocol_fee_rate = 12% plus fund_fee_rate = 4%)
TVL totale : $40M
TVL en plage : $18M (45 % du pool est actuellement en plage)

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

L’interface Raydium affiche 102 % APR pour le pool. (Cet exemple utilise un pool profond et à haut volume pour garder les chiffres concrets ; les pools CLMM typiques affichent entre 10 % et 50 % APR, les pools à faible volume bien en dessous de 10 %.) Maintenant, vous envisagez d’ouvrir une position :

Votre plage : assez étroite pour que vous ayez 2× la concentration moyenne.
Temps en plage attendu : 70 % (vous vérifierez chaque semaine).
Pas de frais Token-2022. Pas de composition automatique.

your_APR ≈ 102% · 2 · 0.70 = 143%

C’est une estimation, pas une garantie. Le volume réalisé peut être divisé par deux ou doublé en une semaine.

Pourquoi l’APR glissant est un signal décalé

L’APR CLMM se déplace rapidement par rapport à l’APR CPMM car le dénominateur TVL en plage se déplace rapidement :

Un grand mouvement de prix pousse des portions de positions hors plage, réduisant le dénominateur. Soudainement, votre TVL en plage restante semble « APR plus élevé » — mais seulement parce que les concurrents sont partis, et généralement le volume baisse aussi.
Un pool atteignant un nouvel ATH peut temporairement afficher 500–1000 % APR pendant une heure car la plupart des positions ont été calibrées pour des prix plus bas et seuls quelques LPs agressifs restent en plage.
Une fois que le marché se stabilise, les LPs rééquilibrent et l’APR revient à la moyenne.

Règles empiriques :

Ignorez l’APR sub-24h. Trop de bruit.
Préférez les fenêtres 7j et 30j. Raydium expose les deux via GET /pools/info/ids — champs week.apr et month.apr.
Testez votre plage spécifique sur les données historiques de volume et de prix avant de consacrer un capital significatif.

Comment les mathématiques fonctionnent (étape de tick unique)

À l’intérieur d’un seul tick, le CLMM se comporte comme un CPMM sur la quantité de liquidité L active dans ce tick. Les frais s’accumulent dans fee_growth_global_X et fee_growth_global_Y par unité de liquidité. Pour une position avec liquidité Lₚ qui s’étend sur les plages de tick [i_lo, i_hi] :

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))

Où fee_growth_inside soustrait la croissance des frais en dessous de i_lo et au-dessus de i_hi de l’accumulateur global. Les détails se trouvent dans algorithms/clmm-math. Pour calculer les frais attendus sur une période future pour une plage prospective, estimez :

expected_fees_per_day = Σ_ticks_in_range (volume_at_tick · fee_rate · your_share_at_tick)

Le SDK Raydium expose PoolUtils.estimateAprsForPriceRangeMultiplier et PoolUtils.estimateAprsForPriceRangeDelta pour cette estimation.

Aide du SDK

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

const raydium = await Raydium.load({ owner, connection });
// getPoolInfoFromRpc prend une chaîne base58 positionnelle sur le module CLMM.
const pool = await raydium.clmm.getPoolInfoFromRpc(POOL_ID);

// Synchrone, et il lit les statistiques de volume/frais hors poolInfo[aprType].
const apr = PoolUtils.estimateAprsForPriceRangeMultiplier({
  poolInfo: pool.poolInfo,
  aprType: "day",                 // "day" | "week" | "month"
  positionTickLowerIndex: -100,   // votre plage prévue
  positionTickUpperIndex:  100,
});

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

L’aide retourne { feeApr, rewardsApr[], apr } — rewardsApr est par flux de récompense et apr est le total. Il n’y a pas de méthode raydium.clmm.estimatedApr. estimateAprsForPriceRangeDelta est le même calcul paramétré par un delta ± autour du spot au lieu de ticks explicites.

Où l’APR de la ferme s’inscrit

Les pools CLMM Raydium peuvent avoir des émissions Farm v6 superposées. Les récompenses de ferme sont payées dans un mint de récompense (souvent RAY ou un token partenaire) indépendant des frais de swap. L’interface Raydium affiche généralement :

Total APR = Fee APR + Farm APR [in $X, Y, Z reward mints]

L’APR de ferme est calculé de manière similaire mais en utilisant le calendrier d’émission des récompenses et le prix actuel du mint de récompense en USD. Contrairement à l’APR de frais, il ne dépend pas de la volatilité — c’est un calendrier fixe. Voir products/farm-staking/overview pour les mathématiques d’émission de ferme.

Erreurs courantes

« L’APR est composé automatiquement. » Non. Les frais doivent être réclamés — via une DecreaseLiquidity à liquidité zéro, puisque CLMM n’a pas d’instruction de collecte autonome — puis redéployés manuellement. Raydium ne compose pas automatiquement les frais CLMM.
« Mon APR = APR principal. » Seulement si votre concentration est moyenne, votre temps en plage est 100 %, et vous composez au même rythme. Les trois sont généralement faux.
« Niveau de frais plus élevé = APR plus élevé. » Seulement si le volume survit aux frais plus élevés. À 1 %, une paire peut afficher 50 % APR mais faire 1/10 du volume ; net moins de 0,25 % à 120 % × 0,1 = 12 %.
« Les positions hors plage ont zéro risque. » Elles ont zéro revenu de frais mais IL complet sur la composition de token existante — la position est maintenant « 100 % de quel que soit le côté ».

Pointeurs

algorithms/clmm-math — dérivation complète de l’accumulateur de croissance des frais.
algorithms/impermanent-loss — le côté perte de l’équation LP.
user-flows/choosing-a-pool-type — cadre de décision qui utilise cette estimation d’APR.
sdk-api/rest-api — points de terminaison de volume/APR en direct.

Sources :

Implémentations Raydium SDK v2 PoolUtils.estimateAprsForPriceRangeMultiplier / estimateAprsForPriceRangeDelta.
Page du pool de l’interface Raydium (champs APR en direct).
Dérivation de croissance des frais Uniswap V3.

Produits

Algorithmes

Estimation de l'APR CLMM

La formule principale

Quel sera réellement votre APR

Exemple travaillé

Pourquoi l’APR glissant est un signal décalé

Comment les mathématiques fonctionnent (étape de tick unique)

Aide du SDK

Où l’APR de la ferme s’inscrit

Erreurs courantes

Pointeurs

​La formule principale

​Quel sera réellement votre APR

​Exemple travaillé

​Pourquoi l’APR glissant est un signal décalé

​Comment les mathématiques fonctionnent (étape de tick unique)

​Aide du SDK

​Où l’APR de la ferme s’inscrit

​Erreurs courantes

​Pointeurs

La formule principale

Quel sera réellement votre APR

Exemple travaillé

Pourquoi l’APR glissant est un signal décalé

Comment les mathématiques fonctionnent (étape de tick unique)

Aide du SDK

Où l’APR de la ferme s’inscrit

Erreurs courantes

Pointeurs