raydium · diff
git:20260131.11703da to git:20260205.5f0b4d5
172 added, 3 removed. Audit A to A.
---
name: raydium
- description: "Raydium AMM - high volume Solana DEX"
+ description: "Raydium - swaps, CLMM positions, AMM liquidity on Solana"
command: ray
emoji: "💜"
gates:
envs:
- SOLANA_PRIVATE_KEY
---
# Raydium DEX
- Raydium is a high-volume AMM on Solana with concentrated liquidity pools.
+ Raydium is a high-volume DEX on Solana with AMM pools and CLMM (Concentrated Liquidity Market Maker) pools.
## Commands
+ ### Swaps
```
/ray swap <amount> <from> to <to> Execute swap on Raydium
- /ray quote <amount> <from> to <to> Get quote
+ /ray quote <amount> <from> to <to> Get quote without executing
/ray pools <token> List pools for token
```
+ ### CLMM (Concentrated Liquidity)
+ ```
+ /ray clmm positions List your CLMM positions
+ /ray clmm create <pool> <lower> <upper> <amount> Open position
+ /ray clmm add <pool> <nft> <amount> Add liquidity to position
+ /ray clmm remove <pool> <nft> [%] Remove liquidity
+ /ray clmm close <pool> <nft> Close position
+ /ray clmm harvest Harvest all rewards
+ ```
+
+ ### AMM Liquidity
+ ```
+ /ray amm add <pool> <amountA> [amountB] Add liquidity
+ /ray amm remove <pool> <lpAmount> 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=<base58 or JSON array>
+ 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 |