AMM v4 費用

0.25% 交易費用、其 LP / 協議分配、OpenBook 成交的 PnL 生成，以及管理員如何清掃累積的協議費用。

本頁內容由 AI 自動翻譯，所有內容以英文版本為準。

查看英文版 →

​

唯一發佈的層級

與 CPMM 和 CLMM 不同，AMM v4 沒有 AmmConfig 帳戶。費用直接儲存在每個池的 AmmInfo.fees 結構中，並在池建立時固定。涵蓋基本上所有現有 AMM v4 池的預設值：

鏈上欄位	預設值	含義
swap_fee_numerator / swap_fee_denominator	25 / 10_000	AMM 路徑交換的總交易費用：輸入量的 0.25%。
trade_fee_numerator / trade_fee_denominator	25 / 10_000	OpenBook 移除後的遺留項目（歷史上用於限價單定價）。預設與 swap_fee 相同，為 0.25%。
pnl_numerator / pnl_denominator	12 / 100	協議的交易費用份額：12% — 即 0.25% × 12% = 0.03% 的交易量。累積到 need_take_pnl_* 計數器。
min_separate_numerator / min_separate_denominator	5 / 10_000	費用分配四捨五入邏輯使用的內部精度下限。

請注意，pnl_numerator / pnl_denominator 是交易費用的分數，而非交易量的分數 — 這是常見的誤讀。LP 份額是補集（費用的 88% = 交易量的 0.22%），是隱含的；沒有單獨的「LP 份額」分子。

少數早期池以不同的分子建立；引用前務必閱讀 AmmInfo.fees。

沒有基金費用和沒有創建者費用行：這些是 CPMM/CLMM 的發明，在 AMM v4 的原始費用模型中不存在。

​

分配如何計算

在每次交換時，池從輸入金額中收取總交易費用，然後分配：

gross_fee   = ceil(amount_in * swap_fee_numerator / swap_fee_denominator)        // amount_in 的 0.25%
pnl_portion = gross_fee * pnl_numerator / pnl_denominator                        // gross_fee 的 12%
lp_portion  = gross_fee − pnl_portion                                            // gross_fee 的 88%

• lp_portion 留在金庫中，並對下一個 k 有所貢獻。LP 稍後通過贖回 LP 代幣來獲取它。
• pnl_portion 增加 AmmInfo.state_data.need_take_pnl_coin 或 need_take_pnl_pc，取決於交換輸入是哪一側。

與 CPMM 相同的不變量保護技巧：PnL 金額物理上位於金庫中，但從曲線中使用的準備金中減去，因此 TakePnl 移動代幣而不改變價格。

​

OpenBook 的 PnL（歷史）

已移除。 OpenBook 整合已從程序中移除，因此本節描述的第二個 PnL 流不再生成。total_pnl_{coin,pc} 計數器現在是已棄用的欄位 — 它們保持凍結的歷史值，永遠不會更新。0.03% 協議費用路徑（上方）不受影響，仍然活躍。

歷史上，AMM v4 有第二個類似費用的收入流：當其在 OpenBook 上的限價單成交時，池可能是成交的接受方，並賺取或支付市場的做市商/接受方價差。這些 PnL 事件在 MonitorStep 期間結算到池金庫中，程序將其記入 state_data.total_pnl_{coin,pc} 作為信息計數器。

• 當池的發佈網格在曲線價格周圍正確校準時，OpenBook 成交往往對池費用為正 — AMM 實際上在 OpenBook 上做市並賺取做市商回扣。
• 當 OpenBook 暫停或事件隊列填滿時，池可能會持有以不利價格成交的過時訂單，產生負 PnL。這種操作耦合是遠離混合設計的動機之一。

這個 OpenBook PnL 不同於 0.03% 協議費用。OpenBook PnL 直接增加池準備金（按費用分配比例使 LP 和協議受益），而 0.03% 協議費用特別標記為管理員清掃。隨著 OpenBook 方面的關閉，今天唯一的費用累積是 AMM 交換上的 0.25% 及其 22/3 分配。

​

收集

管理員（Raydium 多簽）呼叫 WithdrawPnl 將 need_take_pnl_* 清掃到在程序的 AmmConfig 上配置的池級「PnL 所有者」帳戶（一個不同的、程序範圍的配置 — 不是每個池的 CPMM 風格 AmmConfig）。清掃：

1. 從池金庫將 need_take_pnl_coin / need_take_pnl_pc 轉移到 PnL 目的地。
2. 將計數器歸零。

不再有 OpenBook 結算步驟。如果金庫餘額不足以覆蓋累積的 PnL，指令現在直接返回 TakePnlError。該操作不移動曲線 — LP 在 WithdrawPnl 呼叫中不應看到任何價格變化。請注意 WithdrawPnl 帳戶佈局在 2026-07 升級中有所改變（見指令）。

​

LP 費用贖回

沒有專用的「收集 LP 費用」指令。LP 費用在金庫中累積並隨著時間推移增加 k；LP 通過 Withdraw 燒毀 LP 代幣來實現它們。LP 代幣的價值隨著 (coin_reserve_effective, pc_reserve_effective) 增長而單調增長。

​

視覺化：1,000 USDC 交易量的去向

在針對預設參數池的 1,000 美元 USDC 重交換上：

總交易費用 (0.25%):   $2.50
  LP 份額   (0.22%):       $2.20   → 留在池中，提高 k
  PnL 份額  (0.03%):       $0.30   → need_take_pnl_pc，由 TakePnl 清掃
發送給使用者的餘額：   $997.50   (減去曲線驅動的價格影響)

與 CPMM AmmConfig[0]（0.25% 層級，無創建者費用）比較：LP 獲得 $2.10，協議 $0.30，基金 $0.10。CPMM 通過從 AMM v4 等效層級中 LP 本應獲得的部分中切割出來引入基金行。

​

比較表

	AMM v4	CPMM index=0	CLMM index=2
交易費用	0.25%	0.25%	0.25%
LP	0.22%	0.21%	按排放量變化
協議	0.03%	0.03%	按層級
基金	N/A	0.01%	按層級
創建者（可選）	N/A	預設為 0	N/A
費用位置	池金庫 + need_take_pnl_*	池金庫 + protocol_fees_* + fund_fees_*	全局 + 按 tick + 按頭寸

完整矩陣在 reference/fee-comparison。

​

整合商注意事項

• 報價。 通過 SDK 或 api-v3.raydium.io/pools/info/ids 獲取 AmmInfo。準備金現在僅限於金庫，因此你可以直接針對金庫餘額進行報價 — 只需記住減去 need_take_pnl_*（累積的 PnL 保存在金庫中但從曲線中排除）。
• 過時的費用參數。 原則上 SetParams 可以改變 swap_fee_numerator，但實際上 Raydium 多簽尚未為任何現有池改變預設值。儘管如此，始終從鏈上狀態讀取而不是硬編碼。
• 無獎勵。 AMM v4 不支持池上獎勵排放。遺留生態系統農場（Farm v3 / v5 / v6）是質押層等效物 — 見 products/farm-staking。

​

接下來去哪裡

• products/amm-v4/math — 曲線內的交易費用推導。
• products/amm-v4/instructions — WithdrawPnl / SetParams 帳戶列表。
• reference/fee-comparison — 並排矩陣。

來源：

• Raydium AMM 程序 — raydium-io/raydium-amm
• 鏈上 AMM v4 費用分子/分母欄位（針對主網 AmmInfo 帳戶驗證）。