mcpbeat Sign in

Raydium Agent Skill

Complete Raydium Protocol SDK - the single source of truth for integrating Raydium on Solana. Covers SDK, Trade API, CLMM, CPMM, AMM pools, LaunchLab token launches, farming, CPI integration, and all Raydium tools.

36k tokens
context cost
the whole folder, loaded on every use
17
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
122
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/sendaifun/skills --skill raydium

What comes with it

135 564 bytes besides the instruction
docs/clmm-guide.md
docs/troubleshooting.md
examples/clmm-pool/README.md
examples/clmm-position/README.md
examples/cpmm-pool/README.md
examples/farming/README.md
examples/launchlab/README.md
examples/liquidity/README.md
examples/swap/README.md
resources/github-repos.md
resources/launchlab.md
resources/pool-types.md
resources/program-ids.md
resources/sdk-api-reference.md
resources/trade-api.md
templates/raydium-setup.ts

The instruction itself

32 sections, as written by the author

Raydium Protocol - Complete Integration Guide

The definitive guide for integrating Raydium - Solana's leading AMM and liquidity infrastructure powering DeFi since 2021.

What is Raydium?

Raydium is a decentralized exchange on Solana providing:

  • Token Swapping - Fast, cheap swaps via smart routing across all pool types
  • Liquidity Provision - Earn trading fees and rewards by providing liquidity
  • Token Launches - LaunchLab for permissionless token launches with bonding curves
  • Perpetual Trading - Leverage trading on crypto assets

Key Statistics

  • Most widely integrated liquidity infrastructure on Solana
  • 35,000+ tokens launched via LaunchLab (2025)
  • Multiple pool types for different use cases

Core Products

Pool Types

| Type | Description | Best For |

|------|-------------|----------|

| CLMM | Concentrated Liquidity Market Maker | Professional LPs, stablecoin pairs, active management |

| CPMM | Constant Product (x*y=k) with Token22 | New token launches, simple integrations |

| AMM V4 | Classic AMM + OpenBook CLOB | Existing markets, hybrid liquidity |

Additional Features

  • LaunchLab - Permissionless token launches with bonding curves
  • Farms - Yield farming and staking rewards
  • Burn & Earn - Permanent liquidity locking
  • Trade API - HTTP API for swap routing

API Overview

1. SDK (TypeScript)

Package: @raydium-io/raydium-sdk-v2

For programmatic integration with full control over pools, positions, and transactions.

2. Trade API (HTTP)

Base URL: https://transaction-v1.raydium.io

For swap routing - get quotes and serialized transactions via HTTP.

3. Data API

Base URL: https://api-v3.raydium.io

For pool data, token lists, farm info, and configurations.

Quick Start

Installation

npm install @raydium-io/raydium-sdk-v2
# or
yarn add @raydium-io/raydium-sdk-v2

Basic Setup

import { Raydium } from '@raydium-io/raydium-sdk-v2';
import { Connection, Keypair } from '@solana/web3.js';
import bs58 from 'bs58';

// Setup connection and wallet
const connection = new Connection('https://api.mainnet-beta.solana.com');
const owner = Keypair.fromSecretKey(bs58.decode('YOUR_SECRET_KEY'));

// Initialize SDK
const raydium = await Raydium.load({
  connection,
  owner,
  cluster: 'mainnet',
  disableLoadToken: false, // Load token list
});

// Access token data
const tokenList = raydium.token.tokenList;
const tokenMap = raydium.token.tokenMap;

// Access account data
const tokenAccounts = raydium.account.tokenAccounts;

Pool Types

CLMM (Concentrated Liquidity)

Allows LPs to concentrate liquidity in specific price ranges for higher capital efficiency.

// Fetch CLMM pool
const poolId = 'POOL_ID_HERE';
const poolInfo = await raydium.clmm.getPoolInfoFromRpc(poolId);

// Or from API (mainnet only)
const poolData = await raydium.api.fetchPoolById({ ids: poolId });

CPMM (Constant Product)

Simplified AMM without OpenBook market requirement, supports Token22.

// Fetch CPMM pool
const cpmmPool = await raydium.cpmm.getPoolInfoFromRpc(poolId);

AMM (Legacy)

Classic AMM integrated with OpenBook central limit order book.

// Fetch AMM pool
const ammPool = await raydium.liquidity.getPoolInfoFromRpc({ poolId });

Core Operations

Swap

import { CurveCalculator } from '@raydium-io/raydium-sdk-v2';

// Calculate swap
const { amountOut, fee } = CurveCalculator.swapBaseInput({
  poolInfo,
  amountIn: 1000000n, // lamports
  mintIn: inputMint,
  mintOut: outputMint,
});

// Execute CPMM swap
const { execute } = await raydium.cpmm.swap({
  poolInfo,
  inputAmount: 1000000n,
  inputMint,
  slippage: 0.01, // 1%
  txVersion: 'V0',
});

await execute({ sendAndConfirm: true });

Add Liquidity

// CPMM deposit
const { execute } = await raydium.cpmm.addLiquidity({
  poolInfo,
  inputAmount: 1000000n,
  baseIn: true,
  slippage: 0.01,
});

await execute({ sendAndConfirm: true });

Create Pool

// Create CPMM pool
const { execute } = await raydium.cpmm.createPool({
  mintA,
  mintB,
  mintAAmount: 1000000n,
  mintBAmount: 1000000n,
  startTime: new BN(0),
  feeConfig, // from API
  txVersion: 'V0',
});

const { txId } = await execute({ sendAndConfirm: true });

Program IDs

| Program | Mainnet | Devnet |

|---------|---------|--------|

| AMM | 675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8 | DRaya7Kj3aMWQSy19kSjvmuwq9docCHofyP9kanQGaav |

| CLMM | CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK | devi51mZmdwUJGU9hjN27vEz64Gps7uUefqxg27EAtH |

| CPMM | CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C | CPMDWBwJDtYax9qW7AyRuVC19Cc4L4Vcy4n2BHAbHkCW |

API Endpoints

// Mainnet API
const API_URL = 'https://api-v3.raydium.io';

// Devnet API
const DEVNET_API = 'https://api-v3.raydium.io/main/';

// Common endpoints
const endpoints = {
  tokenList: '/mint/list',
  poolList: '/pools/info/list',
  poolById: '/pools/info/ids',
  farmList: '/farms/info/list',
  clmmConfigs: '/clmm/configs',
};

Transaction Options

const { execute } = await raydium.cpmm.swap({
  poolInfo,
  inputAmount,
  inputMint,
  slippage: 0.01,
  txVersion: 'V0', // or 'LEGACY'
  computeBudgetConfig: {
    units: 600000,
    microLamports: 100000, // priority fee
  },
});

// Execute with options
const { txId } = await execute({
  sendAndConfirm: true,
  skipPreflight: true,
});

console.log(`https://solscan.io/tx/${txId}`);

Key Features

| Feature | CLMM | CPMM | AMM |

|---------|------|------|-----|

| Concentrated Liquidity | Yes | No | No |

| Token22 Support | Limited | Yes | No |

| OpenBook Required | No | No | Yes |

| Custom Price Ranges | Yes | No | No |

| LP NFT Positions | Yes | No | No |

LaunchLab (New)

LaunchLab simplifies token launches on Solana with customizable bonding curves:

// Create token with bonding curve via LaunchLab
const { execute } = await raydium.launchLab.createToken({
  name: "My Token",
  symbol: "MTK",
  uri: "https://arweave.net/metadata.json",
  initialSupply: 1_000_000_000n,
  bondingCurve: "linear", // or "exponential"
  graduationThreshold: 85_000_000_000n, // 85 SOL
  txVersion: "V0",
});

const { txId } = await execute({ sendAndConfirm: true });

Bonding Curve Migration

Tokens automatically migrate to AMM pools once they hit the graduation threshold (default: 85 SOL). Creators earn 10% of trading fees post-migration.

Key Milestones (2025)

  • 35,000+ tokens launched via LaunchLab
  • Orb Explorer launched for on-chain analytics

V3 Protocol (Coming)

Raydium V3 introduces a hybrid liquidity model combining:

  • AMM pools with OpenBook's decentralized order book
  • Access to 40% more liquidity across Solana DeFi
  • Enhanced capital efficiency for LPs

Resources

  • SDK: https://github.com/raydium-io/raydium-sdk-V2
  • Demos: https://github.com/raydium-io/raydium-sdk-V2-demo
  • IDL: https://github.com/raydium-io/raydium-idl
  • CLMM Program: https://github.com/raydium-io/raydium-clmm
  • CPMM Program: https://github.com/raydium-io/raydium-cp-swap
  • AMM Program: https://github.com/raydium-io/raydium-amm
  • CPI Examples: https://github.com/raydium-io/raydium-cpi

Skill Structure

raydium/
├── SKILL.md                      # This file - complete integration guide
├── resources/
│   ├── sdk-api-reference.md      # Complete SDK API
│   ├── trade-api.md              # HTTP Trade API reference
│   ├── program-ids.md            # All program addresses
│   ├── pool-types.md             # Pool type comparison
│   ├── launchlab.md              # LaunchLab documentation
│   └── github-repos.md           # GitHub repositories reference
├── examples/
│   ├── swap/README.md            # Token swap examples
│   ├── clmm-pool/README.md       # CLMM pool creation
│   ├── clmm-position/README.md   # CLMM position management
│   ├── cpmm-pool/README.md       # CPMM pool operations
│   ├── liquidity/README.md       # Liquidity management
│   ├── farming/README.md         # Farming and staking
│   └── launchlab/README.md       # LaunchLab token launches
├── templates/
│   └── raydium-setup.ts          # SDK setup template
└── docs/
    ├── clmm-guide.md             # CLMM deep dive
    └── troubleshooting.md        # Common issues

GitHub Repositories

| Repository | Description |

|------------|-------------|

| raydium-sdk-V2 | TypeScript SDK |

| raydium-sdk-V2-demo | SDK examples |

| raydium-clmm | CLMM program (Rust) |

| raydium-cp-swap | CPMM program (Rust) |

| raydium-amm | AMM V4 program (Rust) |

| raydium-cpi | CPI integration examples |

| raydium-idl | IDL definitions |

Other skills for the same job

different authors, same section of the catalogue
MCP Builder
by anthropics
vendor ×13

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

30k tokens scripts
Changelog Generator
by frostant
×9

Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.

774 tokens
Finishing A Development Branch
by ZhanlinCui
×7

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

1k tokens
MCP Builder
by JayZeeDesign
×7

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

37k tokens scripts
Vercel React Native Skills
by vercel-labs
vendor ×6

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

39k tokens
Vercel React Best Practices
by ratacat
×5

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

34k tokens
Next Best Practices
by vercel-labs
vendor ×4

Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling

20k tokens
Using Git Worktrees
by ZhanlinCui
×4

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

1k tokens

How to use it

Copy the folder

Take sendaifun/raydium from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference npm, yarn. Without those the skill loads but fails at the first command.