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.

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

raydium

Skill Assets (1)

Raydium Protocol - Complete Integration Guide

What is Raydium?

Key Statistics

Core Products

Pool Types

Additional Features

API Overview

1. SDK (TypeScript)

2. Trade API (HTTP)

3. Data API

Quick Start

Installation

Basic Setup

Pool Types

CLMM (Concentrated Liquidity)

CPMM (Constant Product)

AMM (Legacy)

Core Operations

Swap

Add Liquidity

Create Pool

Program IDs

API Endpoints

Transaction Options

Key Features

LaunchLab (New)

Bonding Curve Migration

Key Milestones (2025)

V3 Protocol (Coming)

Resources

Skill Structure

GitHub Repositories