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