Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →
Die auf der Raydium-UI angezeigte APR für einen CLMM-Pool ist die realisierte Gebühren-APR der in-range-Liquidität in den letzten 24 Stunden, extrapoliert auf ein Jahr. Sie ist nicht die APR, die Ihre Position verdient hätte — das hängt von Ihrem Bereich, Ihrer Zeit im Bereich und Ihrem Anteil an der Liquidität ab, die während des Handelsfensters aktiv war.

Die Grundformel

Die täglich auf Raydium angezeigte Gebühren-APR für einen CLMM-Pool wird berechnet als:
apr_24h = (fees_24h / tvl_in_range_24h) · 365
Wobei:
  • fees_24h ist die Summe der LP-seitigen Swap-Gebühren der letzten 24 Stunden (in USD).
  • tvl_in_range_24h ist der zeitgewichtete Durchschnittswert der Liquidität in USD, die während des Fensters im Bereich war.
Der Nenner ist das Unterscheidungsmerkmal zwischen CLMM-APR und CPMM-APR. CPMM verwendet die gesamte Pool-TVL, da jeder Dollar immer beitragen kann. CLMM verwendet nur die in-range-Teilmenge, da Dollarbeträge außerhalb des Bereichs nichts verdienen.

Ihre tatsächliche APR

Die angezeigte APR ist eine Statistik des Pools, nicht Ihrer Position. Ihre APR hängt von vier Multiplikatoren ab:
your_APR = headline_APR
         · (your_in_range_fraction / pool_in_range_fraction)     # Konzentrationsvorteil
         · time_in_range                                          # Bereichsdisziplin
         · (1 − transfer_fee_haircut)                             # Token-2022-Steuer
         · compounding_factor                                     # bei Auto-Reinvestition
  • Konzentrationsvorteil. Wenn Ihr Bereich enger ist als der Pool-Durchschnitt, hat jeder aktive Tick mehr Ihrer Liquidität pro Dollar als der durchschnittliche LP. Enger = größerer Vorteil (und proportional größere IL-Verstärkung).
  • Zeit im Bereich. Wenn Sie nur 40 % der Zeit im Bereich sind, multiplizieren Sie mit 0,40.
  • Gebührenabschlag. Bei Token-2022-Ausgaben mit Transfergebühren verursacht jede Gebührenerfassung einen Transfer, der selbst Basispunkte kostet.
  • Verzinsung. Wenn Sie collectFee wöchentlich aufrufen und im gleichen Bereich erneut bereitstellen, liegt die effektive APR bei etwa (1 + daily_APR)^365 − 1. Ohne Verzinsung ist sie linear.

Durchgerechnetes Beispiel

Angenommen, ein SOL/USDC CLMM-Pool hat:
  • 24h-Volumen: $120M
  • Gebührentier: 0,05 % (LP erhält 88 % der Gebühren nach Protokollanteil)
  • Gesamte TVL: $40M
  • In-range TVL: $18M (45 % des Pools sind aktuell im Bereich)
fees_24h = 120M · 0,0005 · 0,88 = $52.800
apr_24h  = (52.800 / 18.000.000) · 365 = 107%
Die Raydium-UI zeigt 107% APR für den Pool. (Dieses Beispiel nutzt einen tiefen, hochvolumigen Pool, um die Zahlen konkret zu halten; typische CLMM-Pools zeigen irgendwo zwischen 10 % und 50 % APR, bei Pools mit niedrigem Volumen deutlich unter 10 %.) Jetzt erwägen Sie die Eröffnung einer Position:
  • Ihr Bereich: eng genug, dass Sie 2× die durchschnittliche Konzentration haben.
  • Erwartete Zeit im Bereich: 70 % (Sie werden wöchentlich überprüfen).
  • Keine Token-2022-Gebühren. Keine Auto-Verzinsung.
your_APR ≈ 107% · 2 · 0,70 = 150%
Das ist eine Schätzung, keine Garantie. Das realisierte Volumen kann sich in einer Woche halbieren oder verdoppeln.

Warum nachgelagerte APR ein verzögertes Signal ist

CLMM-APR bewegt sich schnell im Vergleich zu CPMM-APR, weil der in-range TVL-Nenner schnell schwankt:
  • Ein großer Preissprung drängt Chunks von Positionen aus dem Bereich und verkleinert den Nenner. Plötzlich sieht Ihre verbleibende in-range TVL „höher APR” aus — aber nur weil Konkurrenten gegangen sind und typischerweise auch das Volumen fällt.
  • Ein Pool, der ein neues ATH erreicht, kann temporär 500–1000% APR für eine Stunde zeigen, wenn die meisten Positionen für niedrigere Preise kalibriert wurden und nur noch ein paar aggressive LPs im Bereich sind.
  • Sobald sich der Markt stabilisiert, gleichen LPs erneut aus und die APR normalisiert sich.
Faustregel:
  • Ignorieren Sie APR unter 24h. Zu viel Rauschen.
  • Bevorzugen Sie 7d- und 30d-Fenster. Raydium stellt beide über GET /pools/info/ids zur Verfügung — Felder week.apr und month.apr.
  • Backtesten Sie Ihren spezifischen Bereich anhand von historischen Volumen- und Preisdaten, bevor Sie nennenswertes Kapital binden.

Wie die Mathematik funktioniert (Schritt auf einzelnen Tick)

Innerhalb eines einzelnen Tick verhält sich der CLMM wie ein CPMM auf die in diesem Tick aktive Liquiditätsmenge L. Gebühren sammeln sich in fee_growth_global_X und fee_growth_global_Y pro Liquiditätseinheit an. Für eine Position mit Liquidität Lₚ, die die Tick-Bereiche [i_lo, i_hi] umfasst:
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))
Wobei fee_growth_inside die Gebührenentwicklung unterhalb von i_lo und oberhalb von i_hi vom globalen Akkumulator abzieht. Details in algorithms/clmm-math. Um erwartete Gebühren über einen zukünftigen Zeitraum für einen angestrebten Bereich zu berechnen, schätzen Sie:
expected_fees_per_day = Σ_ticks_in_range (volume_at_tick · fee_rate · your_share_at_tick)
Raydiums SDK stellt getEstimateAprFromPositionAndPool zur Verfügung, das diese Schätzung anhand des aktuellen Volumen-pro-Tick-Histogramms durchführt.

SDK-Helfer

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

const raydium = await Raydium.load({ owner, connection });
const pool = await raydium.clmm.getPoolInfoFromRpc({ poolId });

const apr = await raydium.clmm.estimatedApr({
  poolInfo: pool.poolInfo,
  poolKeys: pool.poolKeys,
  tickLower: -100,   // Ihr beabsichtigter Bereich
  tickUpper:  100,
  volumeUsd24h: pool.poolInfo.day.volume, // oder eine benutzerdefinierte Schätzung
});

console.log(`Erwartete APR: ${apr.feeApr * 100}% (nur Gebühren, ohne Farm-Anreize)`);
Die Methode gibt auch separat die Farm-APR zurück, wenn der Pool an eine Farm angebunden ist. Ihre vollständige „LP-APR” ist feeApr + farmApr.

Wo Farm-APR passt

Raydium CLMM-Pools können Farm v6-Emissionen überlagert haben. Farm-Rewards werden in einem Reward-Mint ausgezahlt (oft RAY oder ein Partner-Token), unabhängig von Swap-Gebühren. Die Raydium-UI zeigt typischerweise:
Gesamt-APR = Gebühren-APR + Farm-APR [in $X, Y, Z Reward-Mints]
Farm-APR wird ähnlich berechnet, aber mit dem Reward-Emissionsplan und dem aktuellen Preis des Reward-Mints in USD. Im Gegensatz zur Gebühren-APR ist sie nicht volatilitätsabhängig — sie folgt einem festen Plan. Siehe products/farm-staking/overview für Farm-Emissions-Mathematik.

Häufige Fehler

  • „APR wird automatisch verzinst.” Nein. Gebühren müssen über collectFee beansprucht und dann manuell erneut bereitgestellt werden. Raydium verzinst CLMM-Gebühren nicht automatisch.
  • „Meine APR = angezeigte APR.” Nur wenn Ihre Konzentration durchschnittlich ist, Ihre Zeit im Bereich 100 % beträgt und Sie mit der gleichen Häufigkeit verzinsen. Alle drei sind normalerweise falsch.
  • „Höheres Gebührentier = höhere APR.” Nur wenn das Volumen das höhere Gebührentier übersteht. Bei 1 % kann ein Paar 50 % APR anzeigen, aber 1/10 des Volumens machen; netto weniger als 0,25 % bei 120 % × 0,1 = 12 %.
  • „Out-of-range-Positionen haben null Risiko.” Sie haben null Gebühreneinnahmen, aber vollständigen IL auf der bestehenden Tokenzusammensetzung — die Position ist jetzt „100 % welche Seite auch immer”.

Verweise

Quellen:
  • Raydium SDK v2 estimatedApr-Implementierung.
  • Raydium UI-Pool-Seite (Live-APR-Felder).
  • Uniswap V3 Gebührenentwicklungs-Herleitung.