메인 콘텐츠로 건너뛰기

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.

이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
Raydium UI에 표시되는 CLMM 풀의 APR은 지난 24시간 동안 범위 내 유동성의 실현 수수료 APR을 연 단위로 투영한 것입니다. 당신의 포지션이 벌었을 APR은 아닙니다. 그것은 범위, 범위 내 체류 시간, 거래 기간 동안 활성화된 유동성의 당신 지분에 따라 달라집니다.

기본 공식

CLMM 풀의 Raydium 일일 수수료 APR은 다음과 같이 계산됩니다:
apr_24h = (fees_24h / tvl_in_range_24h) · 365
여기서:
  • fees_24h는 지난 24시간 동안 적립된 LP측 스왑 수수료 합계(USD)입니다.
  • tvl_in_range_24h는 해당 기간 동안 범위 내에 있던 유동성의 시간 가중 평균 USD 가치입니다.
분모가 CLMM APR을 CPMM APR과 구별합니다. CPMM은 모든 달러가 항상 기여하기 때문에 전체 풀 TVL을 사용합니다. CLMM은 범위 밖의 달러는 수익을 생성하지 않기 때문에 범위 내 부분만 사용합니다.

실제 APR이 어떻게 될지

기본 APR은 풀의 통계이지 포지션의 통계가 아닙니다. 당신의 APR은 네 가지 승수에 따라 달라집니다:
your_APR = headline_APR
         · (your_in_range_fraction / pool_in_range_fraction)     # 집중도 보너스
         · time_in_range                                          # 범위 관리
         · (1 − transfer_fee_haircut)                             # Token-2022 세금
         · compounding_factor                                     # 자동 재투자 시
  • 집중도 보너스. 범위가 풀 전체 평균보다 더 좁으면, 각 활성 틱은 평균 LP의 달러당 유동성이 더 많습니다. 더 좁음 = 더 큰 보너스(그리고 비례적으로 더 큰 IL 증폭).
  • 범위 내 시간. 시간의 40%만 범위 내에 있으면 0.40을 곱하세요.
  • Transfer-fee 차감. Transfer-fee가 있는 Token-2022 민트의 경우, 모든 수수료 수집은 자체적으로 기본 포인트를 손실하는 전송을 통해 이동합니다.
  • 복합 계산. 매주 collectFee를 하고 동일 범위에 재배포하면, 실제 APR은 약 (1 + daily_APR)^365 − 1입니다. 복합 계산 없이는 선형입니다.

계산 예시

SOL/USDC CLMM 풀이 다음을 가지고 있다고 가정해봅시다:
  • 24시간 거래량: $120M
  • 수수료 단계: 0.05% (LP가 프로토콜 컷 후 수수료의 88% 수취)
  • 총 TVL: $40M
  • 범위 내 TVL: $18M (풀의 45%가 현재 범위 내)
fees_24h = 120M · 0.0005 · 0.88 = $52,800
apr_24h  = (52,800 / 18,000,000) · 365 = 107%
Raydium UI는 풀에 107% APR을 표시합니다. (이 예제는 숫자를 구체적으로 유지하기 위해 깊고 높은 거래량의 풀을 사용하며, 일반적인 CLMM 풀은 10%에서 50% APR 사이를 표시하고, 낮은 거래량 풀은 10% 이하입니다.) 이제 당신이 포지션을 오픈할 것을 고려하고 있습니다:
  • 범위: 평균 집중도의 2배를 가질 수 있을 정도로 충분히 좁음.
  • 예상 범위 내 시간: 70% (주 1회 확인).
  • Token-2022 수수료 없음. 자동 복합 계산 없음.
your_APR ≈ 107% · 2 · 0.70 = 150%
이는 추정치이지 보장이 아닙니다. 실현 거래량은 한 주 만에 절반이 되거나 두 배가 될 수 있습니다.

추적 APR이 지연 신호인 이유

CLMM APR은 범위 내 TVL 분모가 빠르게 변하기 때문에 CPMM APR에 비해 빠르게 움직입니다:
  • 큰 가격 변동은 많은 포지션을 범위 밖으로 밀어내고 분모를 줄입니다. 갑자기 남은 범위 내 TVL이 “더 높은 APR”로 보입니다. 하지만 경쟁자들이 떠났을 뿐이고, 일반적으로 거래량도 함께 떨어집니다.
  • 풀이 새로운 ATH에 도달하면, 대부분의 포지션이 더 낮은 가격에 맞춰져 있고 오직 몇몇 공격적인 LP만 범위 내에 남아 있으므로 한 시간 동안 일시적으로 500~1000% APR을 표시할 수 있습니다.
  • 시장이 정착되면, LP는 재균형하고 APR은 평균으로 회귀합니다.
경험 규칙:
  • 24시간 이하의 APR은 무시하세요. 너무 많은 노이즈가 있습니다.
  • 7일 및 30일 윈도우를 선호하세요. Raydium은 GET /pools/info/ids — 필드 week.aprmonth.apr을 통해 둘 다 노출합니다.
  • 의미 있는 자본을 투입하기 전에 역사적 거래량 및 가격 데이터에 대해 특정 범위를 백테스트하세요.

수학이 어떻게 작동하는지 (단일 틱 스텝)

단일 틱 내에서 CLMM은 해당 틱에서 활성화된 유동성 L 양에 대해 CPMM처럼 작동합니다. 수수료는 유동성 단위당 fee_growth_global_Xfee_growth_global_Y에 적립됩니다. 틱 범위 [i_lo, i_hi]를 걸쳐 있는 유동성 Lₚ가 있는 포지션의 경우:
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))
여기서 fee_growth_inside는 전역 누적기에서 i_lo 아래 및 i_hi 위의 수수료 성장을 뺍니다. algorithms/clmm-math의 세부 사항을 참고하세요. 미래 기간에 대한 잠재적 범위의 예상 수수료를 계산하려면 다음을 추정하세요:
expected_fees_per_day = Σ_ticks_in_range (volume_at_tick · fee_rate · your_share_at_tick)
Raydium의 SDK는 최근 틱당 거래량 히스토그램을 사용하여 이 추정을 수행하는 getEstimateAprFromPositionAndPool을 노출합니다.

SDK 헬퍼

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,   // 의도한 범위
  tickUpper:  100,
  volumeUsd24h: pool.poolInfo.day.volume, // 또는 맞춤 추정치
});

console.log(`Expected APR: ${apr.feeApr * 100}% (수수료만, 팜 인센티브 제외)`);
이 방법은 또한 풀에 연결된 팜이 있으면 팜 APR을 별도로 반환합니다. 전체 “LP APR”은 feeApr + farmApr입니다.

팜 APR이 어디에 들어가는지

Raydium CLMM 풀은 최상단에 Farm v6 배출을 계층화할 수 있습니다. 팜 보상은 스왑 수수료와는 독립적인 보상 민트(종종 RAY 또는 파트너 토큰)로 지급됩니다. Raydium UI는 일반적으로 다음을 표시합니다:
Total APR = Fee APR + Farm APR [$X, Y, Z 보상 민트]
팜 APR은 유사하게 계산되지만 보상 배출 일정 및 USD의 보상 민트 현재 가격을 사용합니다. 수수료 APR과 달리 변동성에 의존하지 않습니다. 고정 일정입니다. 팜 배출 수학은 products/farm-staking/overview를 참고하세요.

흔한 실수

  • “APR은 자동으로 복합 계산됩니다.” 아닙니다. 수수료는 collectFee를 통해 청구되어야 하고, 수동으로 재배포되어야 합니다. Raydium은 CLMM 수수료를 자동 복합 계산하지 않습니다.
  • “내 APR = 기본 APR.” 집중도가 평균이고, 범위 내 시간이 100%이며, 동일한 빈도로 복합 계산하는 경우에만 해당됩니다. 세 가지 모두 일반적으로 거짓입니다.
  • “더 높은 수수료 단계 = 더 높은 APR.” 거래량이 더 높은 수수료를 견디는 경우에만 해당됩니다. 1%에서 한 쌍은 50% APR을 인용할 수 있지만 1/10의 거래량을 수행합니다. 0.25%에서는 순 120% × 0.1 = 12%보다 적습니다.
  • “범위 밖 포지션은 위험이 없습니다.” 수수료 수입은 없지만 기존 토큰 구성에 대한 완전한 IL이 있습니다. 포지션은 이제 “어느 쪽이든 100%“입니다.

참고 사항

출처:
  • Raydium SDK v2 estimatedApr 구현.
  • Raydium UI 풀 페이지 (실시간 APR 필드).
  • Uniswap V3 수수료-성장 유도.