raydium

Raydium Protocol Integration Guide

A comprehensive guide for building applications with Raydium - Solana's leading AMM and liquidity protocol.

Overview

Raydium is a suite of automated market makers (AMMs) on Solana offering:

• CLMM - Concentrated Liquidity Market Maker for capital-efficient LP positions
• CPMM - Constant Product Market Maker with Token22 support (no OpenBook required)
• AMM - Classic AMM integrated with OpenBook CLOB
• Farms - Yield farming and staking rewards

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 });