Chuyển đến nội dung chính

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.

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.Xem bản tiếng Anh →
APR hiển thị trên giao diện Raydium cho một pool CLMM là APR phí thực tế của thanh khoản trong phạm vi trong 24 giờ qua, được chiếu cho toàn năm. Đó không phải APR mà vị thế của bạn sẽ kiếm được — điều đó phụ thuộc vào khoảng giá của bạn, thời gian nằm trong phạm vi, và phần chia sẻ thanh khoản của bạn từ tổng thanh khoản hoạt động trong cửa sổ giao dịch.

Công thức tiêu đề

Đối với một pool CLMM, APR phí hàng ngày được hiển thị trên Raydium được tính toán là:
apr_24h = (fees_24h / tvl_in_range_24h) · 365
Trong đó:
  • fees_24h là tổng phí swap phía LP tích lũy trong 24 giờ qua (tính bằng USD).
  • tvl_in_range_24h là giá trị USD trung bình theo thời gian của thanh khoản nằm trong phạm vi trong cửa sổ thời gian.
Mẫu số là điều phân biệt APR CLMM với APR CPMM. CPMM sử dụng tổng TVL của pool vì mỗi đô la đều luôn đóng góp. CLMM chỉ sử dụng tập hợp con trong phạm vi vì các đô la ngoài phạm vi không kiếm được gì.

APR thực tế của bạn sẽ là bao nhiêu

APR tiêu đề là một thống kê của pool, không phải của vị thế của bạn. APR của bạn phụ thuộc vào bốn số nhân:
your_APR = headline_APR
         · (your_in_range_fraction / pool_in_range_fraction)     # concentration bonus
         · time_in_range                                          # range discipline
         · (1 − transfer_fee_haircut)                             # token-2022 tax
         · compounding_factor                                     # if you auto-restake
  • Bonus tập trung (Concentration bonus). Nếu khoảng giá của bạn hẹp hơn mức trung bình của pool, mỗi tick hoạt động có nhiều thanh khoản của bạn hơn trên mỗi đô la so với LP trung bình. Hẹp hơn = bonus lớn hơn (và khuếch đại tổn thất vĩnh viễn tương ứng lớn hơn).
  • Thời gian trong phạm vi (Time in range). Nếu bạn nằm trong phạm vi chỉ 40% thời gian, nhân với 0,40.
  • Tính phí chuyển (Transfer-fee haircut). Đối với các mint Token-2022 có phí chuyển, mỗi lần thu thập phí sẽ đi qua một khoản chuyển tự nó tiêu tốn các điểm cơ sở.
  • Lợi nhuận kép (Compounding). Nếu bạn collectFee và triển khai lại vào cùng khoảng giá hàng tuần, APR hiệu quả khoảng (1 + daily_APR)^365 − 1. Mà không lợi nhuận kép nó là tuyến tính.

Ví dụ thực tế

Giả sử một pool CLMM SOL/USDC có:
  • Khối lượng 24h: $120M
  • Tầng phí: 0,05% (LP nhận 88% phí sau khi cắt giao thức)
  • Tổng TVL: $40M
  • TVL trong phạm vi: $18M (45% của pool hiện nằm trong phạm vi)
fees_24h = 120M · 0.0005 · 0.88 = $52,800
apr_24h  = (52,800 / 18,000,000) · 365 = 107%
Giao diện Raydium hiển thị 107% APR cho pool. (Ví dụ này sử dụng một pool sâu, khối lượng cao để giữ các con số cụ thể; các pool CLMM điển hình hiển thị từ 10% đến 50% APR, với các pool khối lượng thấp tốt dưới 10%.) Bây giờ bạn đang xem xét mở một vị thế:
  • Khoảng giá của bạn: đủ hẹp để bạn có 2× tập trung trung bình.
  • Thời gian dự kiến trong phạm vi: 70% (bạn sẽ kiểm tra hàng tuần).
  • Không có phí Token-2022. Không tự động lợi nhuận kép.
your_APR ≈ 107% · 2 · 0.70 = 150%
Đó là một ước tính, không phải một bảo đảm. Khối lượng thực tế có thể giảm một nửa hoặc gấp đôi trong một tuần.

Tại sao APR theo sau là một tín hiệu chậm

APR CLMM di chuyển nhanh so với APR CPMM vì mẫu số TVL trong phạm vi di chuyển nhanh:
  • Một động thái giá lớn đẩy những phần vị thế ra khỏi phạm vi, làm giảm mẫu số. Bỗng nhiên TVL trong phạm vi còn lại của bạn trông “APR cao hơn” — nhưng chỉ vì các đối thủ cạnh tranh đã rời đi, và điển hình khối lượng cũng giảm.
  • Một pool đạt ATH mới có thể tạm thời hiển thị 500–1000% APR trong một giờ vì hầu hết các vị thế được định cỡ cho giá thấp hơn và chỉ có một vài LP tấn công nằm trong phạm vi.
  • Khi thị trường ổn định, các LP cân bằng lại và APR quay về trung bình.
Các nguyên tắc chung:
  • Bỏ qua APR dưới 24h. Quá nhiều tiếng ồn.
  • Ưu tiên cửa sổ 7d và 30d. Raydium tiếp xúc cả hai thông qua GET /pools/info/ids — các trường week.aprmonth.apr.
  • Kiểm tra ngược lịch sử khoảng giá cụ thể của bạn trên dữ liệu khối lượng và giá lịch sử trước khi cam kết vốn có ý nghĩa.

Cách toán học hoạt động (bước tick đơn)

Bên trong một tick duy nhất, CLMM hoạt động giống như CPMM trên số lượng thanh khoản L hoạt động trong tick đó. Phí tích lũy trong fee_growth_global_Xfee_growth_global_Y trên mỗi đơn vị thanh khoản. Đối với một vị thế có thanh khoản Lₚ trải dài khoảng 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))
Trong đó fee_growth_inside trừ đi tăng trưởng phí dưới i_lo và trên i_hi khỏi bộ tích lũy toàn cầu. Chi tiết trong algorithms/clmm-math. Để tính toán phí dự kiến trong một khoảng thời gian trong tương lai cho một khoảng giá dự kiến, hãy ước tính:
expected_fees_per_day = Σ_ticks_in_range (volume_at_tick · fee_rate · your_share_at_tick)
SDK của Raydium tiếp xúc getEstimateAprFromPositionAndPool để thực hiện ước tính này sử dụng biểu đồ khối lượng trên mỗi tick gần đây.

Trợ giúp 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,   // your intended range
  tickUpper:  100,
  volumeUsd24h: pool.poolInfo.day.volume, // or a custom estimate
});

console.log(`Expected APR: ${apr.feeApr * 100}% (fee-only, excludes farm incentives)`);
Phương thức này cũng trả về riêng biệt bất kỳ APR trang trại nào nếu pool có một trang trại đính kèm. “APR LP” đầy đủ của bạn là feeApr + farmApr.

APR trang trại phù hợp ở đâu

Các pool CLMM của Raydium có thể có phát thải Farm v6 xếp chồng lên trên. Phần thưởng trang trại được trả bằng một mint thưởng (thường là RAY hoặc một token đối tác) độc lập với phí swap. Giao diện Raydium thường hiển thị:
Total APR = Fee APR + Farm APR [in $X, Y, Z reward mints]
APR trang trại được tính toán tương tự nhưng sử dụng lịch phát thải phần thưởng và giá hiện tại của mint phần thưởng tính bằng USD. Không giống như APR phí, nó không phụ thuộc vào biến động — nó là một lịch trình cố định. Xem products/farm-staking/overview để biết toán học phát thải trang trại.

Những sai lầm phổ biến

  • “APR được kép hóa tự động.” Không. Phí phải được yêu cầu qua collectFee, sau đó triển khai lại theo cách thủ công. Raydium không tự động kép hóa phí CLMM.
  • “APR của tôi = APR tiêu đề.” Chỉ khi tập trung của bạn là trung bình, thời gian trong phạm vi của bạn là 100%, và bạn kép hóa với cùng tốc độ. Cả ba thường là sai.
  • “Tầng phí cao hơn = APR cao hơn.” Chỉ khi khối lượng tồn tại ở mức phí cao hơn. Ở 1% một cặp có thể báo giá 50% APR nhưng làm 1/10 khối lượng; ít hơn 0,25% ở 120% × 0,1 = 12%.
  • “Các vị thế ngoài phạm vi có rủi ro bằng không.” Chúng có thu nhập phí bằng không nhưng IL đầy đủ trên thành phần token hiện tại — vị thế bây giờ là “100% bên nào”.

Con trỏ

Nguồn:
  • Triển khai estimatedApr của Raydium SDK v2.
  • Trang pool giao diện Raydium (các trường APR trực tiếp).
  • Dẫn xuất fee-growth của Uniswap V3.