--- name: raydium description: "Raydium - swaps, CLMM positions, AMM liquidity on Solana" command: ray emoji: "💜" gates: envs: - SOLANA_PRIVATE_KEY --- # Raydium DEX Raydium is a high-volume DEX on Solana with AMM pools and CLMM (Concentrated Liquidity Market Maker) pools. ## Commands ### Swaps ``` \/ray swap to Execute swap on Raydium \/ray quote to Get quote without executing \/ray pools List pools for token ``` ### CLMM (Concentrated Liquidity) ``` \/ray clmm positions List your CLMM positions \/ray clmm create Open position \/ray clmm add Add liquidity to position \/ray clmm remove [%] Remove liquidity \/ray clmm close Close position \/ray clmm harvest Harvest all rewards ``` ### AMM Liquidity ``` \/ray amm add [amountB] Add liquidity \/ray amm remove Remove liquidity ``` ## Examples ### Swaps ``` \/ray swap 1 SOL to USDC \/ray quote 100 USDC to RAY \/ray pools SOL ``` ### CLMM Positions ``` \/ray clmm positions # List all positions \/ray clmm create ABC123... 100 200 1000000000 # Open position with price range \/ray clmm add ABC123... NFT456... 500000000 # Add liquidity \/ray clmm remove ABC123... NFT456... 50 # Remove 50% \/ray clmm harvest # Harvest rewards ``` ## Pool Types | Type | Description | Features | |------|-------------|----------| | AMM (V4) | Standard constant-product AMM | Simple, high volume | | CLMM | Concentrated liquidity | Capital efficient, earn fees in range | | CPMM | Constant product (newer) | Lower fees | ## Tools Available ### Swap Tools | Tool | Description | |------|-------------| | `raydium_swap` | Execute swap via Raydium | | `raydium_quote` | Get quote without executing | | `raydium_pools` | List available pools | ### CLMM Tools | Tool | Description | |------|-------------| | `raydium_clmm_positions` | List your CLMM positions | | `raydium_clmm_create_position` | Open new concentrated liquidity position | | `raydium_clmm_increase_liquidity` | Add liquidity to existing position | | `raydium_clmm_decrease_liquidity` | Remove liquidity from position | | `raydium_clmm_close_position` | Close an empty position | | `raydium_clmm_harvest` | Harvest fees and rewards | | `raydium_clmm_swap` | Swap directly on a specific CLMM pool | | `raydium_clmm_create_pool` | Create new CLMM pool | | `raydium_clmm_configs` | Get available fee tier configs | ### AMM Tools | Tool | Description | |------|-------------| | `raydium_amm_add_liquidity` | Add liquidity to AMM pool | | `raydium_amm_remove_liquidity` | Remove liquidity from AMM pool | ## TypeScript API ```typescript import { \/\/ Swaps executeRaydiumSwap, getRaydiumQuote, listRaydiumPools, \/\/ CLMM (Concentrated Liquidity) getClmmPositions, createClmmPosition, increaseClmmLiquidity, decreaseClmmLiquidity, closeClmmPosition, harvestClmmRewards, swapClmm, createClmmPool, getClmmConfigs, \/\/ AMM Liquidity addAmmLiquidity, removeAmmLiquidity, } from 'clodds\/solana\/raydium'; \/\/ Execute swap const swap = await executeRaydiumSwap(connection, keypair, { inputMint: 'So11111111111111111111111111111111111111112', outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', amount: '1000000000', \/\/ 1 SOL in lamports slippageBps: 50, }); \/\/ Open CLMM position const position = await createClmmPosition(connection, keypair, { poolId: 'POOL_ID_HERE', priceLower: 100, priceUpper: 200, baseAmount: '1000000000', \/\/ 1 SOL slippage: 0.01, }); console.log(`Position NFT: ${position.nftMint}`); \/\/ List positions const positions = await getClmmPositions(connection, keypair); for (const pos of positions) { console.log(`Pool: ${pos.poolId}, Liquidity: ${pos.liquidity}`); } \/\/ Add liquidity to position await increaseClmmLiquidity(connection, keypair, { poolId: 'POOL_ID_HERE', positionNftMint: 'NFT_MINT_HERE', amountA: '500000000', \/\/ 0.5 SOL }); \/\/ Harvest rewards const rewards = await harvestClmmRewards(connection, keypair); console.log(`Harvested: ${rewards.signatures.length} transactions`); \/\/ AMM: Add liquidity await addAmmLiquidity(connection, keypair, { poolId: 'AMM_POOL_ID', amountA: '1000000000', fixedSide: 'a', slippage: 0.01, }); \/\/ AMM: Remove liquidity await removeAmmLiquidity(connection, keypair, { poolId: 'AMM_POOL_ID', lpAmount: '1000000', \/\/ LP tokens to burn slippage: 0.1, }); ``` ## Environment Variables ```bash SOLANA_PRIVATE_KEY= SOLANA_RPC_URL=https:\/\/api.mainnet-beta.solana.com # optional ``` ## CLMM Position Management ### Opening a Position 1. Choose a pool (e.g., SOL-USDC) 2. Set price range (lower, upper) 3. Deposit tokens - you'll provide both tokens proportionally ### Managing Positions - **Add liquidity**: Deposit more tokens to existing position - **Remove liquidity**: Withdraw tokens (partial or full) - **Harvest**: Collect trading fees earned - **Close**: Close position after removing all liquidity ### Price Range Strategy | Strategy | Range | Risk\/Reward | |----------|-------|-------------| | Wide range | 50% - 200% of current | Lower fees, less IL | | Narrow range | 95% - 105% | Higher fees, more IL risk | | Full range | 0 - infinity | Like standard AMM |