CLMM 代码示例

本页内容由 AI 自动翻译，所有内容以英文版本为准。查看英文版 →

版本说明。 所有示例针对 @raydium-io/raydium-sdk-v2@0.2.42-alpha 在 Solana mainnet-beta 上运行，已于 2026-04 验证。程序 ID 来自 SDK 中的 reference/program-addresses。

设置

npm install @raydium-io/raydium-sdk-v2 @solana/web3.js @solana/spl-token bn.js decimal.js

本页的每个示例都对应 raydium-sdk-V2-demo/src/clmm 中的一个文件；每个部分旁边都有 GitHub 链接。初始化遵循示例仓库的 config.ts.template（源代码）— 对于任何非平凡的集成，推荐设置 disableFeatureCheck: true：

import { Connection, Keypair, clusterApiUrl } from "@solana/web3.js";
import { Raydium, TxVersion } from "@raydium-io/raydium-sdk-v2";
import fs from "node:fs";

const connection = new Connection(process.env.RPC_URL ?? clusterApiUrl("mainnet-beta"));
const owner = Keypair.fromSecretKey(
  new Uint8Array(JSON.parse(fs.readFileSync(process.env.KEYPAIR!, "utf8"))),
);
const raydium = await Raydium.load({
  owner,
  connection,
  cluster: "mainnet",
  disableFeatureCheck: true,
  blockhashCommitment: "finalized",
});
export const txVersion = TxVersion.V0;

创建 CLMM 池

源代码：src/clmm/createPool.ts

import { PublicKey } from "@solana/web3.js";
import { CLMM_PROGRAM_ID } from "@raydium-io/raydium-sdk-v2";
import BN from "bn.js";
import Decimal from "decimal.js";

const mintA = await raydium.token.getTokenInfo(
  new PublicKey("So11111111111111111111111111111111111111112"));   // wSOL
const mintB = await raydium.token.getTokenInfo(
  new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"));   // USDC

const ammConfigs = await raydium.api.getClmmConfigs();
const ammConfig  = ammConfigs.find((c) => c.index === 1)!;        // 0.05% tier

const initialPrice = new Decimal(160);        // 160 USDC per SOL
const { execute, extInfo } = await raydium.clmm.createPool({
  programId: CLMM_PROGRAM_ID,
  mint1:     mintA,
  mint2:     mintB,
  ammConfig,
  initialPrice,
  startTime: new BN(0),
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Pool:", extInfo.address.id.toBase58(), "tx:", txId);

SDK 会：

按字节顺序对 mint1/mint2 进行排序后再推导。
计算 sqrt_price_x64 = floor(sqrt(initialPrice × 10^(dB−dA)) × 2^64)。
创建 observation 和 tick_array_bitmap_extension 账户。
支付由 ammConfig 定义的池创建费用。

在选定范围内开仓

源代码：src/clmm/createPosition.ts

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

const poolId = new PublicKey("<POOL_ID>");
const { poolInfo, poolKeys, rpcData } = await raydium.clmm.getPoolInfoFromRpc(poolId);

// 选择价格范围。这里：当前价格的 ±10%。
const currentPrice = new Decimal(poolInfo.price);
const lowerPrice   = currentPrice.mul(0.9);
const upperPrice   = currentPrice.mul(1.1);

// 对齐到该池 tick_spacing 的有效 tick。
const { tick: tickLower } = TickUtils.getPriceAndTick({
  poolInfo, price: lowerPrice, baseIn: true,
});
const { tick: tickUpper } = TickUtils.getPriceAndTick({
  poolInfo, price: upperPrice, baseIn: true,
});

// 每种代币的存入数量。
const inputAmount = new BN(10_000_000);  // 0.01 SOL
const inputMint   = poolInfo.mintA.address;

const res = PoolUtils.getLiquidityAmountOutFromAmountIn({
  poolInfo,
  slippage: 0.01,
  inputA: true,
  tickUpper,
  tickLower,
  amount: inputAmount,
  add: true,
  amountHasFee: true,
  epochInfo: await raydium.fetchEpochInfo(),
});

const { execute } = await raydium.clmm.openPositionFromBase({
  poolInfo,
  poolKeys,
  tickUpper,
  tickLower,
  base: "MintA",
  ownerInfo: { useSOLBalance: true },
  baseAmount: inputAmount,
  otherAmountMax: res.amountSlippageB.amount,
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Position opened, tx:", txId);

SDK 会自动计算该范围涉及的 tick 数组，并在任何未初始化的数组上捆绑 InitTickArray 指令。

增加现有仓位的流动性

源代码：src/clmm/increaseLiquidity.ts

const positionNftMint = new PublicKey("<POSITION_NFT_MINT>");

const positionAccount = await raydium.clmm.getPositionInfo({
  nftMint: positionNftMint,
});

const { execute } = await raydium.clmm.increasePositionFromBase({
  poolInfo,
  poolKeys,
  ownerPosition: positionAccount,
  base: "MintA",
  baseAmount: new BN(5_000_000),
  otherAmountMax: new BN(1_000_000_000),
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

减少流动性（同时收取费用）

源代码：src/clmm/decreaseLiquidity.ts 和 src/clmm/closePosition.ts

const { execute } = await raydium.clmm.decreaseLiquidity({
  poolInfo,
  poolKeys,
  ownerPosition: positionAccount,
  liquidity: positionAccount.liquidity.divn(2),   // 减半
  amountMinA: new BN(0),
  amountMinB: new BN(0),
  closePosition: false,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

要仅收取费用，调用 decreaseLiquidity 时设置 liquidity = new BN(0)。该指令的副作用是结算 tokens_fees_owed_{0,1} 并转出它们。要在流动性和费用都清零后完全关闭仓位，在最后一次 decreaseLiquidity 调用时传递 closePosition: true。SDK 会追加 ClosePosition 并销毁 NFT。

受限发行人仓位需要兼容的关闭构建器。 这些仓位有冻结的 NFT 代币账户。ClosePosition 必须将仓位的池 ID 作为第一个剩余账户追加，以便 CLMM 在销毁前解冻该账户。程序源分支不包含 SDK 更改。在启用受限发行人仓位创建之前，请确认你的 SDK 版本明确支持冻结关闭路径。

对于直接的 Anchor 客户端，保持声明的账户不变并追加池：

// CLMM 程序：见 reference/program-addresses；源 ecb1577；
// Solana mainnet-beta；最后验证于 2026-08-13。
await program.methods
  .closePosition()
  .accounts({
    nftOwner,
    positionNftMint,
    positionNftAccount,
    personalPosition,
    systemProgram: SystemProgram.programId,
    tokenProgram: positionNftTokenProgram,
  })
  .remainingAccounts([
    { pubkey: poolId, isWritable: false, isSigner: false },
  ])
  .rpc();

你可以在每次关闭时传递 poolId。CLMM 仅在 positionNftAccount 冻结时读取它，这使一个客户端路径与旧仓位和新仓位都兼容。

收取奖励

源代码：src/clmm/harvestAllRewards.ts

const { execute } = await raydium.clmm.harvestAllRewards({
  ownerInfo: { useSOLBalance: true },
  allPoolInfo: { [poolInfo.id]: poolInfo },
  allPositions: { [poolInfo.id]: [positionAccount] },
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

harvestAllRewards 遍历传入的每个池上的每个仓位，批量处理 CollectReward（和任何 UpdateRewardInfos）指令，如果需要会跨多个交易分割。

交换

源代码：src/clmm/swap.ts

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

const amountIn = new BN(10_000_000);
const baseIn   = true;               // 交换 A (SOL) → B (USDC)
const slippage = 0.005;

const { minAmountOut, remainingAccounts, priceImpact } =
  PoolUtils.computeAmountOutFormat({
    poolInfo,
    tickArrayCache: await raydium.clmm.fetchTickArrays({ poolInfo }),
    amountIn,
    tokenOut: poolInfo.mintB,
    slippage,
    epochInfo: await raydium.fetchEpochInfo(),
  });

const { execute } = await raydium.clmm.swap({
  poolInfo,
  poolKeys,
  inputMint: new PublicKey(poolInfo.mintA.address),
  amountIn,
  amountOutMin: minAmountOut.amount,
  observationId: poolKeys.observationId,
  remainingAccounts,
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });

computeAmountOutFormat 使用与链上程序相同的逻辑离线遍历 tick 映射，并返回：

预期输出数量，
滑点后的最小输出数量，
实际交换将触及的 tick 数组账户列表（remainingAccounts）。

始终传递模拟返回的 remainingAccounts：如果传递的太少，交换会在遍历中途以 TickArrayNotFound 回滚；如果传递过时的，会浪费计算。

创建可自定义的 CLMM 池

createCustomizablePool 是新的入口点，在池创建时暴露动态费用和单边费用切换。它采用与 createPool 相同的形式加上三个新增项：

import { CLMM_PROGRAM_ID, CollectFeeOn } from "@raydium-io/raydium-sdk-v2";

const dynamicFeeConfigs = await raydium.api.getClmmDynamicConfigs();    // GET /main/clmm-dynamic-config
const dynamicFeeConfig  = dynamicFeeConfigs.find((c) => c.index === 0); // 选择一个校准层级

const { execute, extInfo } = await raydium.clmm.createCustomizablePool({
  programId: CLMM_PROGRAM_ID,
  mint1:     mintA,
  mint2:     mintB,
  ammConfig,
  initialPrice,
  startTime: new BN(0),
  // 新字段：
  collectFeeOn:        CollectFeeOn.Token1Only,   // 0 = FromInput, 1 = Token0Only, 2 = Token1Only
  enableDynamicFee:    true,
  dynamicFeeConfigId:  dynamicFeeConfig?.id,      // 当 enableDynamicFee 为 false 时省略
  txVersion: TxVersion.V0,
});

await execute({ sendAndConfirm: true });
console.log("Customizable pool:", extInfo.address.id.toBase58());

createPool 继续用于默认费用、无限价单、无动态费用的路径。当你需要三个新开关中的任何一个时，使用 createCustomizablePool。详见 products/clmm/instructions 的链上账户列表。

限价单

限价单在单个 tick 处停泊用户输入，当交换穿过该 tick 时按 FIFO 成交。输出在结算时推送到所有者的 ATA；所有者无需在线即可成交。

开启限价单

import { TickUtils } from "@raydium-io/raydium-sdk-v2";

const limitConfigs = await raydium.api.getClmmLimitOrderConfigs(); // GET /main/clmm-limit-order-config
const limitConfig  = limitConfigs.find((c) => c.poolId === poolInfo.id);

// 限价必须量化到 tick_spacing。
const targetPrice = new Decimal(180);                              // 以 180 USDC 卖出 SOL
const { tick: limitTick } = TickUtils.getPriceAndTick({
  poolInfo, price: targetPrice, baseIn: true,
});

const { execute } = await raydium.clmm.openLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderConfig: limitConfig,
  inputMint: poolInfo.mintA.address,         // 卖出 SOL
  inputAmount: new BN(50_000_000),           // 0.05 SOL
  tick: limitTick,
  txVersion: TxVersion.V0,
});

const { txId } = await execute({ sendAndConfirm: true });
console.log("Limit order opened, tx:", txId);

SDK 从 (pool, owner, tick, nonce) 推导 LimitOrderState PDA，为每个 (pool, owner) 对增加 LimitOrderNonce，并将订单插入该 tick 处的 FIFO 队列。

增加/减少开放订单

await raydium.clmm.increaseLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderId: <LIMIT_ORDER_PUBKEY>,
  addAmount: new BN(20_000_000),
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

await raydium.clmm.decreaseLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderId: <LIMIT_ORDER_PUBKEY>,
  removeAmount: new BN(10_000_000),
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

decreaseLimitOrder 只能从订单的未成交部分移除；成交部分被锁定直到结算。如果订单已完全成交，两个指令都会以 InvalidOrderPhase 回滚。

结算已成交的订单

await raydium.clmm.settleLimitOrder({
  poolInfo,
  poolKeys,
  limitOrderId: <LIMIT_ORDER_PUBKEY>,
  txVersion: TxVersion.V0,
}).then((b) => b.execute({ sendAndConfirm: true }));

settleLimitOrder 根据队列跟踪器读取订单的 unfilled_ratio_x64，计算成交输出，并将其转移到所有者的 ATA。所有者可以自己调用此方法；limit_order_admin（离线操作守护进程）也可以代表所有者调用 — 输出仍然进入所有者账户。要关闭完全结算的订单以恢复租金，使用 closeLimitOrder（单个）或 closeAllLimitOrder（批量）。要一次结算许多订单，settleAllLimitOrder 会尽可能多地将 SettleLimitOrder 调用打包到一个 v0 交易中。

列出钱包的停泊订单（离线）

// API 助手。见 api-reference/temp-api-v1。
const active = await fetch(
  `https://temp-api-v1.raydium.io/limit-order/order/list?wallet=<your-wallet-pubkey>`,
).then((r) => r.json());

活跃订单端点在一个负载中返回未成交和部分成交的订单（totalAmount / filledAmount / pendingSettle 区分阶段）。对于已关闭订单历史，使用 /limit-order/history/order/list-by-user?wallet=…（按钱包，按 nextPageId 分页）；对于特定订单的完整事件日志，使用 /limit-order/history/event/list-by-pda?pda=…。

Rust CPI 骨架

use anchor_lang::prelude::*;
use raydium_amm_v3::cpi;
use raydium_amm_v3::program::AmmV3;
use raydium_amm_v3::cpi::accounts::SwapV2;

#[derive(Accounts)]
pub struct ProxyClmmSwap<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,
    /// CHECK:
    pub amm_config: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub pool_state: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub input_token_account: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub output_token_account: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub input_vault: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub output_vault: UncheckedAccount<'info>,
    #[account(mut)]
    /// CHECK:
    pub observation_state: UncheckedAccount<'info>,
    /// CHECK:
    pub token_program: UncheckedAccount<'info>,
    /// CHECK:
    pub token_program_2022: UncheckedAccount<'info>,
    /// CHECK:
    pub memo_program: UncheckedAccount<'info>,
    /// CHECK:
    pub input_vault_mint: UncheckedAccount<'info>,
    /// CHECK:
    pub output_vault_mint: UncheckedAccount<'info>,
    pub clmm_program: Program<'info, AmmV3>,
    // `remaining_accounts` 携带 tick_array 和 bitmap_extension 账户。
}

pub fn proxy_swap(
    ctx: Context<ProxyClmmSwap>,
    amount: u64,
    other_amount_threshold: u64,
    sqrt_price_limit_x64: u128,
    is_base_input: bool,
) -> Result<()> {
    let cpi_accounts = SwapV2 {
        payer:                 ctx.accounts.payer.to_account_info(),
        amm_config:            ctx.accounts.amm_config.to_account_info(),
        pool_state:            ctx.accounts.pool_state.to_account_info(),
        input_token_account:   ctx.accounts.input_token_account.to_account_info(),
        output_token_account:  ctx.accounts.output_token_account.to_account_info(),
        input_vault:           ctx.accounts.input_vault.to_account_info(),
        output_vault:          ctx.accounts.output_vault.to_account_info(),
        observation_state:     ctx.accounts.observation_state.to_account_info(),
        token_program:         ctx.accounts.token_program.to_account_info(),
        token_program_2022:    ctx.accounts.token_program_2022.to_account_info(),
        memo_program:          ctx.accounts.memo_program.to_account_info(),
        input_vault_mint:      ctx.accounts.input_vault_mint.to_account_info(),
        output_vault_mint:     ctx.accounts.output_vault_mint.to_account_info(),
    };
    let cpi_ctx = CpiContext::new(ctx.accounts.clmm_program.to_account_info(), cpi_accounts)
        .with_remaining_accounts(ctx.remaining_accounts.to_vec());
    cpi::swap_v2(cpi_ctx, amount, other_amount_threshold, sqrt_price_limit_x64, is_base_input)
}

SwapV2 的剩余账户顺序：

[tick_array_bitmap_extension?, tick_array_0, tick_array_1, …]

如果交换永远不需要扩展，省略它；否则它是第一个剩余账户。

常见陷阱

非对齐 tick 端点 → InvalidTickIndex。始终通过 TickUtils.getPriceAndTick 对齐。
SwapV2 中提供的 tick 数组不足 → TickArrayNotFound。使用 computeAmountOutFormat 获取完整列表。
没有 bitmap 扩展的全范围仓位 → 扩展 PDA 必须可写；SDK 会自动处理。
混淆 sqrt_price_x64 和 price → 这里的因子-2 混淆特别痛苦。有疑问时，让 SDK 从人类可读的价格计算。
过于频繁地收取奖励 → 每次收取需要一个交易。通过 harvestAllRewards 跨多个仓位批量处理。
自己关闭 NFT 账户 → ClosePosition 销毁 NFT 并关闭其 ATA。它也关闭 Token-2022 NFT 铸币；经典 SPL Token 铸币保持供应量为零，因为该程序无法关闭铸币。不要单独关闭支持的账户，否则指令会回滚。
在非对齐 tick 处开启限价单 → InvalidTickIndex。始终通过 TickUtils.getPriceAndTick 量化。
在完全成交的订单上调用 decreaseLimitOrder → InvalidOrderPhase。改用 settleLimitOrder 然后 closeLimitOrder。
在传递 enableDynamicFee: true 时忘记 dynamicFeeConfigId → CreateCustomizablePool 回滚是 InvalidDynamicFeeConfigParams。要么关闭动态费用，要么从 /main/clmm-dynamic-config 选择一个配置。

后续步骤

sdk-api/typescript-sdk — 完整 SDK 表面。
sdk-api/rest-api — 报价和池元数据端点。
user-flows/create-clmm-pool — 非代码演练。
integration-guides/aggregator — 将 CLMM 作为路径的一部分进行路由。

来源：

产品

算法

设置

创建 CLMM 池

在选定范围内开仓

增加现有仓位的流动性

减少流动性（同时收取费用）

收取奖励

交换

创建可自定义的 CLMM 池

限价单

开启限价单

增加/减少开放订单

结算已成交的订单

列出钱包的停泊订单（离线）

Rust CPI 骨架

常见陷阱

后续步骤

​设置

​创建 CLMM 池

​在选定范围内开仓

​增加现有仓位的流动性

​减少流动性（同时收取费用）

​收取奖励

​交换

​创建可自定义的 CLMM 池

​限价单

​开启限价单

​增加/减少开放订单

​结算已成交的订单

​列出钱包的停泊订单（离线）

​Rust CPI 骨架

​常见陷阱

​后续步骤

设置

创建 CLMM 池

在选定范围内开仓

增加现有仓位的流动性

减少流动性（同时收取费用）

收取奖励

交换

创建可自定义的 CLMM 池

限价单

开启限价单

增加/减少开放订单

结算已成交的订单

列出钱包的停泊订单（离线）

Rust CPI 骨架

常见陷阱

后续步骤