# Raydium Docs

## Home

### Home

- [Raydium Documentation](https://docs.raydium.io/index.md): Reference and guides for Raydium's AMM v4, CPMM, CLMM, Farm, and LaunchLab programs on Solana.

## Overview

### Welcome

- [Navigating the documentation](https://docs.raydium.io/introduction/index.md): How to find the right Raydium documentation for your task.
- [What is Raydium](https://docs.raydium.io/introduction/what-is-raydium.md): A plain-English introduction to Raydium — what it does, how its product surfaces fit together, and where it sits in the Solana DeFi landscape.
- [History and milestones](https://docs.raydium.io/introduction/history-and-milestones.md): Raydium's release timeline — product launches, major migrations, significant incidents, and the evolution of the protocol since 2021.
- [Ecosystem position](https://docs.raydium.io/introduction/ecosystem-position.md): Raydium in the broader Solana DeFi landscape — its relationships with OpenBook, aggregators, wallets, oracles, and the Token-2022 ecosystem — and what depending on each means in practice.

### Protocol Overview

- [Protocol Overview](https://docs.raydium.io/protocol-overview/index.md): The end-to-end architecture of Raydium across all four product lines, the infrastructure they share, and how versions have evolved.
- [Architecture](https://docs.raydium.io/protocol-overview/architecture.md): The end-to-end architecture of Raydium: on-chain programs, shared PDAs and config accounts, and the off-chain surface that fronts them.
- [Shared infrastructure](https://docs.raydium.io/protocol-overview/shared-infrastructure.md): The primitives every Raydium program shares — authority PDAs, AmmConfig accounts, the protocol/fund/creator fee split, observation accounts, and the public REST API surface — defined once so per-product chapters can refer back here.
- [Versions and migration](https://docs.raydium.io/protocol-overview/versions-and-migration.md): Release-version history for every Raydium program, the deprecation status of each generation, and the practical migration paths between them.

## User Guide

### Getting started

- [Trust & safety](https://docs.raydium.io/getting-started/trust-and-safety.md): Stay safe while using Raydium and other dApps. How to prevent and detect scams that drains Solana Users.
- [User Flows](https://docs.raydium.io/user-flows/index.md): Task-oriented guides: swap, add/remove liquidity, create a pool or farm, and launch or buy a token.
- [FAQ](https://docs.raydium.io/getting-started/faq.md): Consolidated answers to the questions new Raydium users actually ask: fees, failed transactions, LP tokens, unwrapping SOL, finding transactions, and more.

#### First steps

- [Getting Started](https://docs.raydium.io/getting-started/index.md): Zero-to-first-trade guide for non-developer users: pick a wallet, fund it, do your first swap, and avoid the common scams. Everything you need before opening Raydium for the first time.
- [What you need](https://docs.raydium.io/getting-started/what-you-need.md): The absolute minimum prerequisites to use Raydium: a Solana wallet, some SOL, and a browser. Five-minute checklist.
- [Choosing a wallet](https://docs.raydium.io/getting-started/choosing-a-wallet.md): How to pick a Solana wallet for using Raydium: the features that matter, the security choices to make, and what to verify before you sign.
- [Funding a wallet](https://docs.raydium.io/getting-started/funding-your-wallet.md): Three ways to get SOL into your Solana wallet: fiat on-ramps, cross-chain bridges, and centralized exchange withdrawals. Tradeoffs in speed, fees, and friction.
- [Your first swap](https://docs.raydium.io/getting-started/first-swap.md): Step-by-step walk-through of a single SOL → USDC swap on raydium.io/swap. What to enter, what to expect on each screen, and how to verify it worked.

### For Traders

#### Swap

- [Swap](https://docs.raydium.io/user-flows/swap.md): Executing a token swap through the Raydium UI: choose tokens, review the route, set slippage and priority fees, sign, and troubleshoot common failures.
- [Referrals & Blinks](https://docs.raydium.io/user-flows/referrals-and-blinks.md): Generate a Raydium swap link that pays you a 1% referral fee on every swap made through it. When shared on X, compatible wallets render the link as an interactive Blink.

#### Perpetuals

- [Perpetuals](https://docs.raydium.io/user-flows/perpetuals.md): Start trading Raydium Perps: open the perps app, create an account, deposit collateral, and place your first order.
- [Perpetuals trading basics](https://docs.raydium.io/user-flows/perpetuals-trading-basics.md): A trader-focused primer for Raydium Perps: long and short positions, leverage, margin, liquidation, funding, and order execution.
- [Perpetuals order types](https://docs.raydium.io/user-flows/perpetuals-order-types.md): Order types and flags available on Raydium Perps: market, limit, stop, scale, IOC, FOK, post-only, and reduce-only.
- [Multi-collateral deposit](https://docs.raydium.io/user-flows/perpetuals-multi-collateral-deposit.md): Deposit supported collateral for Raydium Perps and understand global and per-user collateral limits.
- [Perpetuals trading fees](https://docs.raydium.io/user-flows/perpetuals-trading-fees.md): Trading and withdrawal fees on Raydium Perps, including maker fees, taker tiers, and Orderly infrastructure fees.

### For Liquidity Providers

- [Add or remove liquidity](https://docs.raydium.io/user-flows/add-remove-liquidity.md): Deposit, withdraw, harvest farm rewards, and collect CLMM fees and rewards through the Raydium UI.
- [Burn & Earn (permanent liquidity lock)](https://docs.raydium.io/user-flows/burn-and-earn.md): Permanently lock a CPMM or CLMM LP position while retaining the right to claim trading fees via a transferable Raydium Fee Key NFT.
- [Claim rewards](https://docs.raydium.io/user-flows/claim-rewards.md): Harvest farm rewards and collect CLMM fees and rewards through the Raydium UI.
- [Migrate AMM v4 → CPMM](https://docs.raydium.io/user-flows/migrate-amm-v4-to-cpmm.md): Move liquidity from an AMM v4 pool to a CPMM pool through Raydium: checklist, UI steps, verification, and common concerns.

#### Pool Creation

- [Pool Creation](https://docs.raydium.io/user-flows/choosing-a-pool-type.md): Choose the right Raydium pool type before creating a CPMM pool, CLMM pool, or farm.
- [Create a CPMM pool](https://docs.raydium.io/user-flows/create-cpmm-pool.md): Create a Raydium CPMM pool through the UI: choose tokens, set the fee tier and initial price, seed liquidity, and verify the pool.
- [Create a CLMM pool](https://docs.raydium.io/user-flows/create-clmm-pool.md): Create a concentrated-liquidity pool through the Raydium UI: choose fee tier, set initial price, open the first range, and verify.
- [Create a farm](https://docs.raydium.io/user-flows/create-farm.md): Create a Raydium farm through the UI to incentivize LP holders: choose staking mint, reward mints, schedule, budget, and monitoring.

### For Token Creators

- [LaunchLab overview](https://docs.raydium.io/user-flows/launchlab-overview.md): What LaunchLab is, who it is for, and how token launches move from bonding curve trading to Raydium pool liquidity.
- [Buying a LaunchLab token](https://docs.raydium.io/user-flows/buying-a-launchlab-token.md): How to find, research, and buy a token on Raydium LaunchLab — including risk factors, slippage settings, and what happens when the bonding curve graduates.
- [Creating a LaunchLab token](https://docs.raydium.io/user-flows/creating-a-launchlab-token.md): Two creation modes — JustSendit for a fast no-config launch, LaunchLab for full control over supply, curve, vesting, and post-migration fees. Covers UI walkthrough, key decisions, and what to do after launch.
- [Earn referral fees (LaunchLab)](https://docs.raydium.io/user-flows/earn-referral-fees-launchlab.md): Share a LaunchLab token page link with your wallet as the referrer and earn 0.1% of every trade that comes through it — paid automatically in SOL.
- [How creator fees work](https://docs.raydium.io/user-flows/how-creator-fees-work.md): How LaunchLab creator fees accrue on the bonding curve and after CPMM graduation, separately from the platform-owned Fee Key.
- [LaunchLab platforms](https://docs.raydium.io/user-flows/launchlab-platforms.md): How third-party platform configurations shape LaunchLab launches, fees, branding, and post-migration settings.

## Products

### Products

- [Products](https://docs.raydium.io/products/index.md): Quick comparison of Raydium product surfaces and when to use each one.

#### AMM v4

- [AMM v4](https://docs.raydium.io/products/amm-v4/index.md): Constant-product AMM. Originally a hybrid design that shared liquidity to OpenBook; the OpenBook dependency has since been removed from the program.
- [AMM v4 overview](https://docs.raydium.io/products/amm-v4/overview.md): Raydium's original constant-product AMM. Originally a hybrid design that mirrored the curve as limit orders onto OpenBook; the OpenBook dependency has been removed from the program and pools now operate as pure AMMs.
- [AMM v4 accounts](https://docs.raydium.io/products/amm-v4/accounts.md): The full account inventory of an AMM v4 pool — AmmInfo, TargetOrders, OpenOrders, vaults, LP mint, authority — plus the OpenBook accounts the pool is bound to.
- [AMM v4 math](https://docs.raydium.io/products/amm-v4/math.md): Constant-product invariant with AMM v4's fee convention, reserve-to-orderbook price conversion, target-order grid construction, and the PnL settlement step.
- [AMM v4 instructions](https://docs.raydium.io/products/amm-v4/instructions.md): Every AMM v4 instruction with its arguments, the pool and OpenBook accounts it expects, and the pre/post conditions on each.
- [AMM v4 fees](https://docs.raydium.io/products/amm-v4/fees.md): The 0.25% trade fee, its LP / protocol split, PnL generation from OpenBook fills, and how the admin sweeps accrued protocol fees.
- [AMM v4 code demos](https://docs.raydium.io/products/amm-v4/code-demos.md): TypeScript examples for swapping against and providing liquidity to an existing AMM v4 pool. New pool creation is out of scope — use CPMM instead.

#### CPMM

- [CPMM (Standard AMM)](https://docs.raydium.io/products/cpmm/index.md): Pure constant-product AMM. No OpenBook dependency. Token-2022 compatible. The recommended program for new constant-product pools.
- [CPMM overview](https://docs.raydium.io/products/cpmm/overview.md): What Raydium's CPMM (Standard AMM) is, what makes it different from AMM v4, and when to pick it.
- [CPMM accounts](https://docs.raydium.io/products/cpmm/accounts.md): Every PDA and shared account a CPMM pool touches: PoolState, AmmConfig, authority, LP mint, token vaults, and the observation ring buffer.
- [CPMM math](https://docs.raydium.io/products/cpmm/math.md): The constant-product invariant, SwapBaseInput vs SwapBaseOutput, Token-2022 transfer-fee handling, and how the observation account is updated.
- [CPMM instructions](https://docs.raydium.io/products/cpmm/instructions.md): Every instruction on the CPMM program, with its arguments, account list, pre/post conditions, and the errors it can return.
- [CPMM fees](https://docs.raydium.io/products/cpmm/fees.md): How CPMM charges a trade fee and a separate creator fee, splits the trade fee between LPs, the protocol treasury, and the fund multisig, splits a configurable share of the creator fee to the protocol at collection time, and who collects what, when.
- [CPMM code demos](https://docs.raydium.io/products/cpmm/code-demos.md): End-to-end TypeScript examples for every CPMM operation — create pool, swap, deposit, withdraw, collect fees — plus a minimal Rust CPI skeleton.

#### CLMM

- [CLMM](https://docs.raydium.io/products/clmm/index.md): Concentrated-liquidity AMM. Liquidity is deposited into price ranges (ticks); positions earn fees only when the price is in range.
- [CLMM overview](https://docs.raydium.io/products/clmm/overview.md): What Raydium's CLMM is, how concentrated liquidity differs from a constant-product pool, and when to pick it over CPMM or AMM v4.
- [CLMM accounts](https://docs.raydium.io/products/clmm/accounts.md): Every account a CLMM pool touches: PoolState, AmmConfig, TickArrayState, TickArrayBitmapExtension, PersonalPositionState, and Observation.
- [Ticks and positions](https://docs.raydium.io/products/clmm/ticks-and-positions.md): How CLMM discretizes price into ticks, how tick-arrays compress storage, and the rules governing where a position can live.
- [CLMM math](https://docs.raydium.io/products/clmm/math.md): Sqrt-price representation, liquidity ↔ token amounts, the single-tick swap step, multi-tick iteration, and fee-growth accounting.
- [CLMM instructions](https://docs.raydium.io/products/clmm/instructions.md): Complete CLMM instruction reference: pool lifecycle, position management, swap, and reward streams.
- [CLMM fees and rewards](https://docs.raydium.io/products/clmm/fees.md): How CLMM splits a trade fee across LPs, protocol, and fund; how the three-slot reward system emits to in-range positions; and how both settle into per-position balances.
- [CLMM code demos](https://docs.raydium.io/products/clmm/code-demos.md): End-to-end TypeScript examples: create a CLMM pool, open a position in a chosen price range, adjust liquidity, swap, and collect fees and rewards.

#### Farm / Staking

- [Farm / Staking](https://docs.raydium.io/products/farm-staking/index.md): Reward distribution program for LP tokens and single-asset staking.
- [Farm / Staking overview](https://docs.raydium.io/products/farm-staking/overview.md): How Raydium's farm program distributes reward tokens to stakers — the per-share accounting, the farm-version generations (v3, v5, v6), and how farms relate to but are distinct from the AMM / CLMM pools they sit alongside.
- [Farm / Staking accounts](https://docs.raydium.io/products/farm-staking/accounts.md): FarmState, UserStake / Ledger, reward vaults, and the authority PDAs — layouts and PDA seeds for farm v3, v5, and v6.
- [Farm / Staking instructions](https://docs.raydium.io/products/farm-staking/instructions.md): CreateFarm, Deposit, Withdraw, Harvest, AddReward / SetRewards / RestartRewards, WithdrawReward — the full instruction surface across farm v3, v5, and v6.
- [Farm / Staking code demos](https://docs.raydium.io/products/farm-staking/code-demos.md): TypeScript examples for creating a farm, staking LP, harvesting rewards, and topping up reward budgets against Raydium's farm v6 program.

#### Perps

- [Raydium Perps](https://docs.raydium.io/products/perps/index.md): Gasless central-limit-order-book perpetuals on Solana (perps.raydium.io), powered by Orderly Network. Up to 100× leverage, multi-collateral, cross-margin, one-way mode.
- [Trading basics](https://docs.raydium.io/products/perps/trading-basics.md): Perpetual futures primer: going long / short, leverage mechanics, cross-margin, one-way mode, liquidation and slippage risk.
- [Order types](https://docs.raydium.io/products/perps/order-types.md): The five order shapes Raydium Perps supports — Market, Limit, Stop (market / limit), Scale — plus the four order flags: IOC, FOK, Post-Only, Reduce-Only.
- [Collateral](https://docs.raydium.io/products/perps/collateral.md): Supported collateral assets, per-chain global caps, per-user deposit caps, and how USDC-settled P&L interacts with non-USDC collateral.
- [Perps fees](https://docs.raydium.io/products/perps/fees.md): Maker 0 bps, volume-tiered taker schedule, Orderly's 1 bps cut, and the flat 1 USDC withdrawal fee.
- [Perps code demos](https://docs.raydium.io/products/perps/code-demos.md): Programmatic access to Raydium Perps via Orderly Network's API: deposit USDC, register the trading account, place / cancel / amend orders, fetch positions, subscribe to a market WebSocket, and withdraw.

#### Stable AMM

- [Stable AMM](https://docs.raydium.io/products/stable/index.md): Standalone Raydium program with interpolated price curves from lookup tables. Powers liquidity for stablecoin pairs and other assets with known price relationships.
- [Stable AMM overview](https://docs.raydium.io/products/stable/overview.md): Stable AMM is a standalone Raydium program that replaces the constant-product curve with an interpolated lookup table, reducing slippage for correlated assets.
- [Stable AMM accounts](https://docs.raydium.io/products/stable/accounts.md): AmmInfo, ModelDataInfo, DataElement, Fees, and vault layout. The full account inventory of a Stable AMM pool (a standalone, pure-AMM Raydium program).
- [Stable AMM math](https://docs.raydium.io/products/stable/math.md): Binary search and linear interpolation to quote prices from the lookup table. Fee application identical to AMM v4. Pure-AMM pool accounting after the OpenBook decoupling.
- [Stable AMM instructions](https://docs.raydium.io/products/stable/instructions.md): The currently callable instruction set — Deposit, Withdraw, SwapBaseIn, SwapBaseOut, WithdrawPnl — plus the instructions removed in the 2026-06-22 upgrade.
- [Stable AMM fees](https://docs.raydium.io/products/stable/fees.md): One low fee tier: 0.02% gross trade fee, 88% LP / 12% protocol. Same Fees struct as AMM v4, different numbers. No fund fee, no creator fee.
- [Stable AMM code demos](https://docs.raydium.io/products/stable/code-demos.md): How to identify a Stable AMM pool from the API, swap through it via the Liquidity module (it handles version=5 pools natively), and use the off-chain stable-curve helpers.

#### AMM Routing

- [AMM Routing](https://docs.raydium.io/products/routing/index.md): A program that chains swaps across multiple pools (AMM v4, CPMM, CLMM, Stable) in a single transaction, with user-controlled intermediate ATAs.
- [Routing overview](https://docs.raydium.io/products/routing/overview.md): What the AMM Routing program does, why it exists as a separate program, and when to use it instead of client-side instruction stitching.
- [Routing accounts](https://docs.raydium.io/products/routing/accounts.md): How accounts are passed per hop on the AMM Routing program: user ATAs for every intermediate token, then the per-pool account block for each leg of the route.
- [Routing math](https://docs.raydium.io/products/routing/math.md): The router performs no pricing math itself; each hop delegates to its pool program's curve. Multi-hop slippage compounds; CLMM hops use limit_prices.
- [Routing instructions](https://docs.raydium.io/products/routing/instructions.md): Reference for the AMM Routing instructions enabled on mainnet — six variants covering exact-input / exact-output swaps and the wSOL utilities.
- [Routing fees](https://docs.raydium.io/products/routing/fees.md): The router takes no fee. Each hop pays its pool's fee. Compute cost scales linearly with route depth.
- [Routing code demos](https://docs.raydium.io/products/routing/code-demos.md): TypeScript examples: SDK-based multi-hop swap through the router, and raw instruction building.

### Algorithms

- [Algorithms](https://docs.raydium.io/algorithms/index.md): Mathematical deep-dive chapter: the invariants, pricing formulas, and edge cases behind every Raydium product.
- [Constant-product AMM](https://docs.raydium.io/algorithms/constant-product.md): The x·y=k invariant, reserve-based pricing, slippage derivation, and the fee handling variants used by Raydium CPMM and AMM v4. This is the reference math page every x·y=k product at Raydium links back to.
- [Concentrated-liquidity math](https://docs.raydium.io/algorithms/clmm-math.md): sqrt-price representation, liquidity-to-amount formulas, single-tick and multi-tick swap steps, fee-growth accounting — the math behind Raydium CLMM.
- [Bonding curves](https://docs.raydium.io/algorithms/bonding-curves.md): The mathematics behind token-issuance curves — quadratic, linear, and virtual-reserves CPMM variants — derivations for cost / proceeds / spot price, and the graduation-threshold math used by LaunchLab.
- [Slippage and price impact](https://docs.raydium.io/algorithms/slippage-and-price-impact.md): Precise definitions of slippage vs price impact, how Raydium's SDK sizes minAmountOut and maxAmountIn, differences across AMM types, and MEV considerations for production routing.
- [Token-2022 transfer fees in swaps](https://docs.raydium.io/algorithms/token-2022-transfer-fees.md): How Token-2022's transfer-fee extension changes the pre/post-swap amount accounting, which Raydium products support it, and the edge cases integrators need to handle (asymmetric fees, fee updates, max-fee caps, non-transferable extensions).
- [Impermanent loss](https://docs.raydium.io/algorithms/impermanent-loss.md): The fundamental LP risk: value lost relative to simply holding the two tokens. Formulas for CPMM (constant-product) and CLMM (concentrated-liquidity) pools, worked examples, and the break-even fee-APR thresholds that matter for LPs.
- [Estimating CLMM APR](https://docs.raydium.io/algorithms/clmm-apr.md): How Raydium computes the APR numbers shown on CLMM pools, how to estimate your own APR for a hypothetical range before opening a position, and the edge cases that make trailing APR misleading.

## Launch tools

### LaunchLab

- [LaunchLab](https://docs.raydium.io/products/launchlab/index.md): Bonding-curve token-launch venue that graduates into a Raydium AMM pool once funding targets are met.
- [LaunchLab overview](https://docs.raydium.io/products/launchlab/overview.md): How Raydium's bonding-curve launch venue works end-to-end: pre-graduation trading against a deterministic curve, the funding threshold that triggers graduation, and the automatic migration into a standard CPMM pool.
- [LaunchLab bonding curve](https://docs.raydium.io/products/launchlab/bonding-curve.md): The curve formulas LaunchLab supports, closed-form buy and sell cost, graduation threshold derivation, and a worked numeric walk-through of a launch from first buy to graduation.
- [LaunchLab accounts](https://docs.raydium.io/products/launchlab/accounts.md): PoolState (per-launch root), the base and quote vaults, the authority PDA, and the small graph of per-launch accounts. Protocol-level GlobalConfig and platform-level PlatformConfig live on their own pages.
- [LaunchLab GlobalConfig](https://docs.raydium.io/products/launchlab/global-config.md): Protocol-level configuration accounts that bound every LaunchLab launch — fee rates, supply minimums, lock-rate ceilings, the migration wallets that gate graduation, and the per-curve indexing scheme.
- [LaunchLab PlatformConfig](https://docs.raydium.io/products/launchlab/platform-config.md): Per-platform configuration that customizes branding, fee splits, NFT migration shares, vesting allocation, and the launch-parameter rules for any launch routed through that platform.
- [LaunchLab curve rules](https://docs.raydium.io/products/launchlab/curve-rules.md): How a platform constrains the launch parameters its creators may pick: check groups, the (field, op, value) constraint model, and nine playbooks — exact tiers, value bands, graduation-valuation caps, migration floors, token-type gating, and time-boxed promos.
- [LaunchLab vesting](https://docs.raydium.io/products/launchlab/vesting.md): Locked tokens, cliff and linear-unlock schedule, the VestingRecord per-beneficiary account, and the create / claim instructions creators and platforms use to distribute reserved supply after graduation.
- [LaunchLab instructions](https://docs.raydium.io/products/launchlab/instructions.md): Initialize, Buy, Sell, Graduate, CollectFees, SetParams — argument shapes, account lists, and pre/postconditions for every LaunchLab instruction.
- [LaunchLab code demos](https://docs.raydium.io/products/launchlab/code-demos.md): End-to-end TypeScript: create a LaunchLab launch, buy and sell on the bonding curve, graduate into a CPMM pool, and collect creator fees.
- [LaunchLab platforms](https://docs.raydium.io/products/launchlab/platforms.md): How third parties register a Platform PDA on LaunchLab to offer their own branded token-launch experience, set platform fees, and configure post-migration parameters.
- [LaunchLab creator fees](https://docs.raydium.io/products/launchlab/creator-fees.md): How creator fees accrue before graduation and through the CPMM pool creator after graduation, separately from platform-owned locked LP.

### Token launch flow

- [Launch a token (LaunchLab)](https://docs.raydium.io/user-flows/launch-token-launchlab.md): End-to-end token launch through LaunchLab: curve choice, initial configuration, monitoring pre-graduation bonding-curve activity, and verifying the graduated CPMM pool.

### Tips & Gotchas

- [Tips & Gotchas](https://docs.raydium.io/products/launchlab/tips-and-gotchas/index.md): Operational notes for LaunchLab platforms: fee lifecycle, LP distribution, CPMM fee configs, creator fees, and fee redistribution.
- [LaunchLab & CPMM fee reference](https://docs.raydium.io/products/launchlab/tips-and-gotchas/launchlab-cpmm-fee-reference.md): End-to-end fee flow for LaunchLab tokens from bonding curve trading through CPMM migration.
- [LP fee distribution](https://docs.raydium.io/products/launchlab/tips-and-gotchas/lp-fee-distribution.md): How LaunchLab combines platform and creator scales into platform-owned locked LP and burns the remaining CPMM LP tokens.
- [Redistribute creator fees](https://docs.raydium.io/products/launchlab/tips-and-gotchas/redistribute-creator-fees.md): How LaunchLab platforms can redirect CPMM creator fees to a platform wallet or PDA and redistribute them off-chain or through custom logic.

## {} Developer Guide

### Solana fundamentals

- [Solana Fundamentals](https://docs.raydium.io/solana-fundamentals/index.md): The minimum Solana primitives you need to understand the Raydium programs — account model, SPL / Token-2022, PDAs, CPIs, transactions, fees, and toolchain.
- [Account model](https://docs.raydium.io/solana-fundamentals/account-model.md): Solana's account-centric architecture — accounts hold state, programs are stateless code that operates on accounts. Rent, ownership, program accounts vs data accounts, and what it all means when you're reading Raydium's pool state.
- [Rent and reclaimable rent](https://docs.raydium.io/solana-fundamentals/rent-and-reclaimable-rent.md): Solana is cutting the rent-exempt minimum by 90% across five steps under SIMD-0437. Accounts funded before each step now hold more than they need — what that excess is, which programs hand it back, and how to find and reclaim it.
- [SPL Token and Token-2022](https://docs.raydium.io/solana-fundamentals/spl-token-and-token-2022.md): The two token standards Raydium operates on — the legacy SPL Token program and the extensions-enabled Token-2022 program. What each is, how they differ, and which Raydium products support which.
- [Transactions and fees](https://docs.raydium.io/solana-fundamentals/transactions-and-fees.md): How Solana transactions are structured, the limits they operate under, and the two distinct categories of fees — Solana network fees and Raydium protocol fees — that a typical swap pays.
- [PDAs and CPIs](https://docs.raydium.io/solana-fundamentals/pdas-and-cpis.md): Program-derived addresses and cross-program invocation — the two primitives Raydium uses to manage state deterministically and compose with other programs. Seeds, bumps, invoke vs invoke_signed, and the patterns Raydium's code follows.
- [Programs and Anchor](https://docs.raydium.io/solana-fundamentals/programs-and-anchor.md): How Solana programs are deployed and upgraded, what the Anchor framework adds on top of raw Solana, and how to read Raydium's IDL to generate your own clients.
- [Toolchain](https://docs.raydium.io/solana-fundamentals/toolchain.md): Minimum working setup for reading Raydium on-chain state, building transactions, and developing against the programs. Solana CLI, Anchor, SDKs in TypeScript and Python, and devnet/localnet tips.

### Quick start

- [Quick start](https://docs.raydium.io/quick-start/index.md): Three scripts that swap, create a CPMM pool, and create a CLMM pool with an initial position — real on-chain output, minimum config. The swap and CPMM scripts are paste-and-go; the CLMM flow takes a few extra steps.
- [Swap from CLI](https://docs.raydium.io/quick-start/swap-from-cli.md): Paste-and-go Node script that quotes and executes a CPMM swap. Configure four env vars and run it.
- [Deploy a CPMM pool](https://docs.raydium.io/quick-start/deploy-cpmm-pool.md): Paste-and-go Node script that creates a new CPMM pool. Configure mints and seed amounts via env vars.
- [Deploy a CLMM pool](https://docs.raydium.io/quick-start/deploy-clmm-pool.md): Four-file TypeScript flow that creates a new CLMM pool, then opens an initial concentrated position. Run with npx tsx; mirrors the official raydium-sdk-V2-demo flow.

### SDK & API

- [SDK & API](https://docs.raydium.io/sdk-api/index.md): Reference for Raydium's TypeScript SDK, REST API, Anchor IDLs, and integration patterns for Rust, Python, and AI tools.
- [TypeScript SDK](https://docs.raydium.io/sdk-api/typescript-sdk.md): @raydium-io/raydium-sdk-v2 end-to-end — installation, the four module facades, transaction building, and the gotchas that bite every new integrator.
- [REST API surface](https://docs.raydium.io/sdk-api/rest-api.md): High-level overview of Raydium's eleven public HTTP services — what each one does, the conventions they share (response envelope, auth, rate limits, caching), and how to pick the right service for an integration.
- [Trade API](https://docs.raydium.io/sdk-api/trade-api.md): Raydium's server-built swap transaction endpoint: quote, build, sign, send. The integration pattern for apps that want Raydium routing without shipping the SDK — what it returns, how it differs from the SDK, and how aggregators consume it.
- [Anchor IDL](https://docs.raydium.io/sdk-api/anchor-idl.md): Where to find each Raydium program's IDL, how to regenerate TS / Rust / Python clients from it, and the protocol's IDL-change policy.
- [Rust CPI](https://docs.raydium.io/sdk-api/rust-cpi.md): Invoking Raydium programs from another Solana program via CPI: account list construction, signer seeds, remaining accounts, and error propagation for CPMM, CLMM, and LaunchLab. AMM v4 (no Anchor crate) and Farm v6 are covered in their own sections.
- [Python integration](https://docs.raydium.io/sdk-api/python-integration.md): Building Raydium-facing bots and backends in Python via solders, solana-py, and anchorpy — environment setup, reading pool state, sending swaps, and the typical bot architecture.
- [AI integration](https://docs.raydium.io/sdk-api/ai-integration.md): Plug Raydium docs into your coding agent or LLM workflow — MCP server, llms.txt index, per-page copy, and pre-built context files.

### Integration guides

- [Integration Guides](https://docs.raydium.io/integration-guides/index.md): Recipes for common integration scenarios: aggregators, wallets, program-to-program CPI, routing, and performance tuning.
- [Aggregator integration](https://docs.raydium.io/integration-guides/aggregator.md): How to discover Raydium pools, quote across CPMM / CLMM / AMM v4, and route atomic swaps through the right set of programs. Written for DEX aggregators and wallet swap UIs.
- [Wallet integration](https://docs.raydium.io/integration-guides/wallet-integration.md): Displaying Raydium positions, pool shares, farm stakes, and pending rewards in a wallet UI — detection patterns, simulation for transaction preview, and Token-2022 display specifics.
- [CPI from a custom program](https://docs.raydium.io/integration-guides/cpi-integration.md): Composition patterns for on-chain programs that call Raydium — escrows, aggregator proxies, auto-compounding vaults — with full worked examples that include account construction, PDA signers, remaining accounts, and compute-budget budgeting.
- [Routing and MEV](https://docs.raydium.io/integration-guides/routing-and-mev.md): Split routing across Raydium products, sandwich-resistance patterns, Jito bundle integration, and the trade-offs between private- and public-mempool submission paths.
- [Priority fees and compute budget](https://docs.raydium.io/integration-guides/priority-fee-tuning.md): Right-sizing compute-unit limits and priority fees for Raydium transactions — benchmarks per instruction, estimation strategies, and congestion-handling patterns.

## Security & Ops

### Security & risk

- [Security & Risk](https://docs.raydium.io/security/index.md): Audit history, admin controls, known risk surface, attack vectors, and responsible disclosure.
- [Audits](https://docs.raydium.io/security/audits.md): Audit history per Raydium program — firm, scope, date, report link — plus fix-status tracking and commentary on what audits do and don't cover.
- [Admin keys and multisig](https://docs.raydium.io/security/admin-and-multisig.md): The authority surface across Raydium programs — what each admin can do, how the multisig is structured, and how to verify on-chain who currently holds each role.
- [Oracle and token risks](https://docs.raydium.io/security/oracle-and-token-risks.md): How Raydium handles oracle inputs and the specific risks introduced by Token-2022 extensions — freeze authority, transfer hook, permanent delegate, default-frozen — including what the programs protect against and what users must accept.
- [Attack vectors](https://docs.raydium.io/security/attack-vectors.md): Known attack patterns against AMMs and Raydium's specific exposures — sandwich/MEV, price manipulation, donation attacks, Token-2022 hook abuse, composability bugs — including how Raydium defends against each.
- [Responsible disclosure](https://docs.raydium.io/security/disclosure.md): Raydium's bug-bounty program: scope (on-chain program code only), severity tiers and rewards, contact paths (Immunefi or security email), payout structure, plus the non-bounty channel for reporting SDK / UI / API issues.

### RAY token & Protocol revenues

- [RAY](https://docs.raydium.io/ray/index.md): RAY supply, mint address, emissions, allocation, vesting, utility, and safety checks.
- [Protocol fees](https://docs.raydium.io/ray/protocol-fees.md): Raydium trading-fee splits, pool-creation fees, fee conventions, and verification notes.
- [Buybacks](https://docs.raydium.io/ray/ray-buybacks.md): How Raydium trading fees route into buybacks and how to verify the flow on-chain.
- [Treasury](https://docs.raydium.io/ray/treasury.md): Protocol multisig, fee collection, buyback, treasury, and pool-creation fee addresses.
- [Staking](https://docs.raydium.io/ray/ray-staking.md): How to stake and unstake RAY in the Raydium app.
- [Protocol metrics & analytics](https://docs.raydium.io/ray/protocol-metrics-and-analytics.md): Dashboards, reports, and APIs for tracking Raydium activity.
- [White paper](https://docs.raydium.io/ray/ray-token-white-paper.md): Official Raydium Protocol (RAY) token crypto-asset white paper, prepared under Regulation (EU) 2023/1114 (MiCAR).

## >_ Api Reference

### Overview

- [API reference](https://docs.raydium.io/api-reference/index.md): Catalogue of every Raydium-operated HTTP API: pool data, transaction construction, perps, the LaunchLab forum / mint / history / auth services, IPFS gateway, owner-positions, and the legacy Python API. Endpoints listed below open into an interactive playground.
- [Raydium API v3](https://docs.raydium.io/api-reference/api-v3/overview.md): REST API for querying Raydium pools, mints, farms, and chain data on Solana
- [Transaction API Overview](https://docs.raydium.io/api-reference/route-api-v2/overview.md): Server-side swap transaction builder for Solana.
- [Perps API Overview](https://docs.raydium.io/api-reference/perp-api-v1/overview.md): Configuration and metadata service for Raydium Perpetual Futures.
- [Dynamic IPFS API](https://docs.raydium.io/api-reference/dynamic-ipfs-v1/overview.md): Regenerate dynamic NFT metadata and position visuals for Raydium liquidity positions
- [Owner API](https://docs.raydium.io/api-reference/owner-api-v1/overview.md): Retrieve per-wallet positions, balances, and claimable rewards
- [API v1](https://docs.raydium.io/api-reference/api-v1/overview.md): Legacy Raydium read API at api.raydium.io. Pool / pair / farm / SDK lists. Kept live for clients that have not migrated to API v3.
- [Temp API](https://docs.raydium.io/api-reference/temp-api-v1/overview.md): Temporary holding area for short-lived endpoints

#### LaunchLab APIs

- [LaunchLab Mint API](https://docs.raydium.io/api-reference/launch-mint-v1/overview.md): Search, leaderboards, per-mint metadata, vesting queries, and mint-creation flows for LaunchLab tokens.
- [LaunchLab History API](https://docs.raydium.io/api-reference/launch-history-v1/overview.md): Trade history and OHLC kline data for LaunchLab pools at 1m, 5m, and 15m intervals.
- [LaunchLab Forum API](https://docs.raydium.io/api-reference/launch-forum-v1/overview.md): Pool comment threads, IPFS image uploads, and forum browsing tied to a LaunchLab launch. Wallet-signed via ray-token.
- [LaunchLab Auth API](https://docs.raydium.io/api-reference/launch-auth-v1/overview.md): Wallet-signature handshake that mints short-lived ray-token JWTs for the LaunchLab Forum and Mint APIs.

### API v3

#### Main

- [Get main statistics](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-main-statistics.md): Retrieve TVL and 24-hour volume for all Raydium pools. Cached 60 seconds.
- [Get chain time offset](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-chain-time-offset.md): Get offset between local UTC time and Solana chain time. Cached 60 seconds.
- [Get estimated transaction fees](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-estimated-transaction-fees.md): Retrieve estimated on-chain costs (lamports). Cached 60 seconds.
- [Get RAY stake pools](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-ray-stake-pools.md): Retrieve RAY token staking pools. Cached 60 seconds.
- [Get CLMM pool configurations](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-clmm-pool-configurations.md): Retrieve allowed configurations for concentrated liquidity pools. Cached 60 seconds.
- [Get CPMM pool configurations](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-cpmm-pool-configurations.md): Retrieve allowed configurations for constant-product pools. Cached 60 seconds.
- [Get CLMM dynamic-fee configurations](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-clmm-dynamic-fee-configurations.md): Retrieve the calibrated `DynamicFeeConfig` tiers a new CLMM pool can opt into when `enableDynamicFee=true` is passed to `CreateCustomizablePool`. Each entry exposes the per-tier parameters (filter period, decay period, reduction factor, dynamic-fee control, max volatility accumulator) that govern th…
- [Get CLMM limit-order configurations](https://docs.raydium.io/api-reference/api-v3-endpoints/main/get-clmm-limit-order-configurations.md): Retrieve the per-pool limit-order configuration (whether limit orders are enabled, the minimum order size, and the keeper public key) for pools that support limit orders. Used by SDKs and UIs before calling `OpenLimitOrder`. Cached 60 seconds.

#### Mint

- [Get default mint list](https://docs.raydium.io/api-reference/api-v3-endpoints/mint/get-default-mint-list.md): Retrieve UI's default mint list with metadata and logos. Cached 60 seconds.
- [Get mint info by IDs](https://docs.raydium.io/api-reference/api-v3-endpoints/mint/get-mint-info-by-ids.md): Retrieve metadata for specific mint addresses. Cached 20 seconds.
- [Get mint prices](https://docs.raydium.io/api-reference/api-v3-endpoints/mint/get-mint-prices.md): Retrieve current USD prices for mint tokens. Cached 5 seconds.

#### Pools

- [Get pool info by IDs](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/get-pool-info-by-ids.md): Retrieve detailed pool information by pool IDs. Cached 60 seconds.
- [Get pools by LP mint](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/get-pools-by-lp-mint.md): Retrieve pool info by LP token addresses. Cached 60 seconds.
- [List pools with pagination](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/list-pools-with-pagination.md): **Legacy endpoint.** Retrieve paginated pool list with filtering and sorting. Cached 60 seconds. pageSize limited to 1000. Kept live for existing integrations; new integrations should query pools by ID, mint pair, or LP mint via the other `/pools/info/*` endpoints, or use the indexer-backed routing…
- [Get pools by token mint](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/get-pools-by-token-mint.md): Filter pools by one or two token mints. Mint ordering normalized internally. Cached 60 seconds.
- [List pools with advanced filters (v2)](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/list-pools-with-advanced-filters-v2.md): Advanced pool listing with cursor-based pagination. Cached 60–90 seconds.
- [Get pool on-chain keys](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/get-pool-on-chain-keys.md): Retrieve on-chain account keys for pools. Cached 60 seconds.
- [Get pool liquidity history](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/get-pool-liquidity-history.md): Retrieve historical TVL data for a pool (up to 30 days). Cached 300 seconds.
- [Get CLMM position history](https://docs.raydium.io/api-reference/api-v3-endpoints/pools/get-clmm-position-history.md): Retrieve historical price and liquidity data for CLMM pools. Cached 30 seconds.

#### Farms

- [Get farm info by IDs](https://docs.raydium.io/api-reference/api-v3-endpoints/farms/get-farm-info-by-ids.md): Retrieve farm pool details by farm IDs. Cached 60 seconds.
- [Get farms by LP mint](https://docs.raydium.io/api-reference/api-v3-endpoints/farms/get-farms-by-lp-mint.md): Search for farms by LP token stake address. Paginated. Cached 60 seconds.
- [Get farm on-chain keys](https://docs.raydium.io/api-reference/api-v3-endpoints/farms/get-farm-on-chain-keys.md): Retrieve on-chain account keys for farms. Cached 60 seconds.

#### IDO

- [Get IDO pool keys](https://docs.raydium.io/api-reference/api-v3-endpoints/ido/get-ido-pool-keys.md): Retrieve on-chain structure for IDO pools. Cached 20 seconds.

### Transaction API

#### Compute

- [Compute swap quote (base input)](https://docs.raydium.io/api-reference/route-api-v2-endpoints/compute/compute-swap-quote-base-input.md): Calculate the expected output amount when swapping a fixed input amount. Useful for displaying a preview before transaction building.
- [Compute swap quote (base output)](https://docs.raydium.io/api-reference/route-api-v2-endpoints/compute/compute-swap-quote-base-output.md): Calculate the required input amount to achieve a desired output amount. Useful for swaps where you know the target output.

#### Transaction

- [Build swap transaction (base input)](https://docs.raydium.io/api-reference/route-api-v2-endpoints/transaction/build-swap-transaction-base-input.md): Generate a serialized swap transaction for a fixed input amount. Requires a successful compute response from `/compute/swap-base-in`.
- [Build swap transaction (base output)](https://docs.raydium.io/api-reference/route-api-v2-endpoints/transaction/build-swap-transaction-base-output.md): Generate a serialized swap transaction for a desired output amount. Requires a successful compute response from `/compute/swap-base-out`.

### Perps API

#### Main

- [Get perp market statistics](https://docs.raydium.io/api-reference/perp-api-v1-endpoints/main/get-perp-market-statistics.md): Returns 24h/7d/30d trading volume and open interest (long/short/total).

#### Pool

- [Get default perp pool list](https://docs.raydium.io/api-reference/perp-api-v1-endpoints/pool/get-default-perp-pool-list.md): Returns list of default perpetual trading pools with volume and stats.

### LaunchLab APIs

#### Mint API

##### Discovery

- [Search mints](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/discovery/search-mints.md)
- [Get featured top mint](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/discovery/get-featured-top-mint.md)
- [Get featured recent mints](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/discovery/get-featured-recent-mints.md)
- [List mints with sorting](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/discovery/list-mints-with-sorting.md)
- [List Bonk mints](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/discovery/list-bonk-mints.md)

##### Details

- [Get mint details](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/details/get-mint-details.md)
- [Get user mints](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/details/get-user-mints.md)

##### User Activity

- [Get user volume stats](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/user-activity/get-user-volume-stats.md)
- [Get user creation stats](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/user-activity/get-user-creation-stats.md)
- [Get referrer rewards](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/user-activity/get-referrer-rewards.md)

##### Configuration

- [Get platform config](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/configuration/get-platform-config.md)
- [Get platforms](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/configuration/get-platforms.md): **Legacy endpoint.** Returns the v1 platform list. Superseded by `/campaign/platforms-v2`, which carries the additional fields the front end now relies on. New integrations should call the v2 endpoint.
- [Get platforms v2](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/configuration/get-platforms-v2.md)

##### Creation

- [Submit mint creation](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/creation/submit-mint-creation.md): Register the off-chain metadata for a new LaunchLab mint before its on-chain create transaction is sent. The platform stores the supplied name/symbol/uri/social-links keyed by mint, so the UI can display them while the bonding curve is live.
- [Get random mint](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/creation/get-random-mint.md): Return a fresh, unused mint keypair for the caller. Optional filters let the platform pre-generate vanity addresses with a specific prefix/suffix.
- [Submit transaction](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/creation/submit-transaction.md): Forward a fully signed Solana transaction (base64-encoded) on behalf of the caller. Used by the UI to relay the create / buy / sell transactions through the platform's RPC for priority-fee uplift and retry handling.

##### Vesting

- [Get vesting by IDs](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/vesting/get-vesting-by-ids.md)
- [Get pool vesting](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/vesting/get-pool-vesting.md)
- [Get owner vesting](https://docs.raydium.io/api-reference/launch-mint-v1-endpoints/vesting/get-owner-vesting.md)

#### History API

##### Candle Data

- [Get kline (candlestick) data](https://docs.raydium.io/api-reference/launch-history-v1-endpoints/candle-data/get-kline-candlestick-data.md): Retrieve OHLC candle data. Limit range: 1-500 (default 300).

##### Trades

- [Get trade history](https://docs.raydium.io/api-reference/launch-history-v1-endpoints/trades/get-trade-history.md): Retrieve individual trades. Limit range: 1-100 (default 50).

#### Forum API

##### Comments

- [Post a comment on a pool](https://docs.raydium.io/api-reference/launch-forum-v1-endpoints/comments/post-a-comment-on-a-pool.md): Post a new comment. Requires ray-token header.
- [Get comments for a pool](https://docs.raydium.io/api-reference/launch-forum-v1-endpoints/comments/get-comments-for-a-pool.md)
- [Get a specific comment by ID](https://docs.raydium.io/api-reference/launch-forum-v1-endpoints/comments/get-a-specific-comment-by-id.md)

#### Auth API

##### Token Management

- [Request authentication token with signature](https://docs.raydium.io/api-reference/launch-auth-v1-endpoints/token-management/request-authentication-token-with-signature.md): Signs a message with format `{signText}{time}` where signText is "Sign in to raydium.io: " and time is the current Unix timestamp in seconds. The wallet must sign this message and submit the signature to receive a JWT token.
- [Request token using Ledger transaction](https://docs.raydium.io/api-reference/launch-auth-v1-endpoints/token-management/request-token-using-ledger-transaction.md): Alternative token request for Ledger-signed transactions. Signs a message with format `{signText}{time}` within a transaction.
- [Validate authentication token](https://docs.raydium.io/api-reference/launch-auth-v1-endpoints/token-management/validate-authentication-token.md): Verify that a token is still valid. Also extends token lifetime if near expiry.
- [Revoke authentication token](https://docs.raydium.io/api-reference/launch-auth-v1-endpoints/token-management/revoke-authentication-token.md)

### Dynamic IPFS API

#### CLMM Position

- [Get CLMM position metadata](https://docs.raydium.io/api-reference/dynamic-ipfs-v1-endpoints/clmm-position/get-clmm-position-metadata.md): Fetch complete position metadata including pool details, liquidity amounts, unclaimed fees, and USD valuation. Returns a dynamic NFT interface object suitable for rendering position visuals.

#### Locked Positions

- [Get locked CLMM position metadata](https://docs.raydium.io/api-reference/dynamic-ipfs-v1-endpoints/locked-positions/get-locked-clmm-position-metadata.md): Fetch metadata for a locked CLMM position. Returns position data including lock duration, accumulated fees, and current valuation.
- [Get locked CPMM position metadata](https://docs.raydium.io/api-reference/dynamic-ipfs-v1-endpoints/locked-positions/get-locked-cpmm-position-metadata.md): Fetch metadata for a locked Constant Product Market Maker position. Returns LP token amounts, pool share percentage, and claimable fees from locking.

### Owner API

#### Position

- [Get stake positions for a wallet](https://docs.raydium.io/api-reference/owner-api-v1-endpoints/position/get-stake-positions-for-a-wallet.md): Retrieve all stake (standard AMM or CPMM) positions owned by this wallet. Returns cached position data including amounts and rewards.
- [Get locked CLMM positions for a wallet](https://docs.raydium.io/api-reference/owner-api-v1-endpoints/position/get-locked-clmm-positions-for-a-wallet.md): Retrieve all locked Concentrated Liquidity Market Maker positions owned by this wallet. Returns position state including locked amounts, lock end time, and claimable fees.

#### Pool Creation

- [Get pools created by a wallet](https://docs.raydium.io/api-reference/owner-api-v1-endpoints/pool-creation/get-pools-created-by-a-wallet.md): Retrieve all CPMM pools created (launched) by this wallet.

#### IDO

- [Get IDO participation info for a wallet](https://docs.raydium.io/api-reference/owner-api-v1-endpoints/ido/get-ido-participation-info-for-a-wallet.md): Retrieve IDO participation data, including invested amounts and claim status.

### API v1

#### Ray Token

- [Get RAY total supply](https://docs.raydium.io/api-reference/api-v1-endpoints/ray-token/get-ray-total-supply.md): Fetch RAY token total coin supply.
- [Get RAY circulating supply](https://docs.raydium.io/api-reference/api-v1-endpoints/ray-token/get-ray-circulating-supply.md): Fetch RAY token circulating supply.

### Temp API

#### Temporary

- [List a wallet's currently-parked CLMM limit orders](https://docs.raydium.io/api-reference/temp-api-v1-endpoints/temporary/list-a-wallets-currently-parked-clmm-limit-orders.md): Return CLMM limit orders owned by `wallet` that are still on-chain — both fully unfilled and partially filled orders are returned in a single payload. Each row is the decoded on-chain `LimitOrderState` plus the pool keys and a `pendingSettle` amount that the indexer has computed from the latest tick…
- [List a wallet's historical CLMM limit orders](https://docs.raydium.io/api-reference/temp-api-v1-endpoints/temporary/list-a-wallets-historical-clmm-limit-orders.md): Return closed CLMM limit orders owned by `wallet`. Each row summarizes the order at the time it left the active set. Cursor-paginated via `nextPageId`.
- [List the on-chain event log for one or more limit-order PDAs](https://docs.raydium.io/api-reference/temp-api-v1-endpoints/temporary/list-the-on-chain-event-log-for-one-or-more-limit-order-pdas.md): Return the event log (`open`, `increase`, `decrease`, `settle`, `close`) for one or more limit-order PDAs. Useful for rendering a per-order timeline. Cursor-paginated via `nextPageId`.
- [Get accumulated creator fees for a wallet](https://docs.raydium.io/api-reference/temp-api-v1-endpoints/temporary/get-accumulated-creator-fees-for-a-wallet.md): Retrieve all CPMM pools where this wallet is the creator, along with accumulated but unclaimed creator fees per pool. Returns an empty array if the wallet has no creator fees cached.

## Reference

### Reference

- [Reference](https://docs.raydium.io/reference/index.md): Lookup tables: program addresses, error codes, fee comparisons, glossary, and changelog.
- [Program addresses](https://docs.raydium.io/reference/program-addresses.md): Canonical Raydium program IDs and shared PDAs on Solana mainnet-beta and devnet. Every other page links here instead of hardcoding addresses.
- [Error codes](https://docs.raydium.io/reference/error-codes.md): Anchor error enums for every Raydium on-chain program, with cause and recommended UX message.
- [Fee comparison](https://docs.raydium.io/reference/fee-comparison.md): Side-by-side fee matrix across all Raydium products — swap fees, protocol shares, creation costs, and how Token-2022 transfer fees stack on top. A single-page lookup for expected costs.
- [Token-2022 support matrix](https://docs.raydium.io/reference/token-2022-support.md): Which Raydium programs support Token-2022, the explicit extension allow-list each program enforces at pool creation, and the one remaining bypass — the admin-managed per-mint registry PDA — that admits otherwise-rejected mints.
- [Glossary](https://docs.raydium.io/reference/glossary.md): Definitions of terms used throughout Raydium's documentation. Each entry has a one-line definition and a pointer to the page where the term is explained in depth.

#### Changelog

- [Changelog](https://docs.raydium.io/reference/changelog.md): Timeline index of updates to this documentation set. Each release links to its own page detailing which chapters changed, why, and when the content was verified against on-chain state and the program source.
- [2026-09-30 — CLMM: Anchor 1.0, excess-lamports recovery, and fixed fee owners](https://docs.raydium.io/reference/changelog/2026-09-30-clmm-anchor-1-and-excess-lamports.md): CLMM moves to Anchor 1.0.2 on Agave 3.1.10 and adds an admin CollectExcessLamports instruction for rent freed by SIMD-0437, swept one pool at a time with the pool PDA as signer. CreateAmmConfig now writes hardcoded protocol and fund fee owners instead of the signer. Error 6052 is appended. No user-f…
- [2026-09-19 — CPMM: the protocol takes a share of the creator fee](https://docs.raydium.io/reference/changelog/2026-09-19-cpmm-creator-fee-protocol-share.md): CPMM can now retain a configurable share of the creator fee, applied when the fee is collected rather than when it is charged. AmmConfig gains creator_fee_share_rate (carved from padding, same size), a new CreatorFeeShare PDA overrides it per creator, and CreateCreatorFeeShare / CloseCreatorFeeShare…
- [2026-09-09 — LaunchLab: Anchor 1.0, excess-lamports recovery, and the end of the transition gates](https://docs.raydium.io/reference/changelog/2026-09-09-launchlab-anchor-1-and-excess-lamports.md): LaunchLab moves to Anchor 1.0.2 on Agave 3.1.10 and adds an admin CollectExcessLamports instruction for rent freed by SIMD-0437. Three transition mechanisms are retired: the deprecated Initialize now always fails, MigrateToAmm loses three arguments and nine OpenBook accounts, and the clock-based get…
- [2026-09-09 — CPMM: Anchor 1.0, excess-lamports recovery, and fixed fee owners](https://docs.raydium.io/reference/changelog/2026-09-09-cpmm-anchor-1-and-excess-lamports.md): CPMM moves to Anchor 1.0.2 on Agave 3.1.10 and adds an admin CollectExcessLamports instruction for rent freed by SIMD-0437. CreateAmmConfig now writes hardcoded protocol and fund fee owners instead of the signer, the four-address Token-2022 mint whitelist is removed, and ClosePermissionPda accepts t…
- [2026-09-09 — AMM v4: Solana 3.0 dependencies and excess-lamports recovery](https://docs.raydium.io/reference/changelog/2026-09-09-amm-v4-solana-3-and-excess-lamports.md): AMM v4 rebuilds against solana-program 3.0, spl-token 9.0 and the new solana-system-interface crate, and adds an admin-only WithdrawExcessLamports instruction (tag 18) that returns rent freed by SIMD-0437. CreateConfigAccount stops reading its trailing rent sysvar, compatibly. Nothing breaks and no…
- [2026-08-31 — LaunchLab: platform curve rules replace the curve-parameter whitelist](https://docs.raydium.io/reference/changelog/2026-08-31-launchlab-platform-curve-rules.md): Launch-parameter restrictions move from PlatformConfig.curve_params into per-config PlatformCurveRule accounts with (field, op, value) constraints, value bands, ORed check groups, and a delegated manager wallet. PlatformConfig keeps its 944-byte size; the legacy field and its two instructions are re…
- [2026-08-27 — LaunchLab: platform holds the withdraw-withheld authority from mint creation](https://docs.raydium.io/reference/changelog/2026-08-27-launchlab-token2022-withheld-authority.md): InitializeWithToken2022 now writes PlatformConfig.transfer_fee_extension_auth into the new base mint's withdraw_withheld_authority instead of the launch authority PDA, and MigrateToCpswap only reassigns that authority when the PDA still holds it. No account layout, instruction, or error change.
- [2026-08-26 — LaunchLab: platform fee rate cap raised to 500 bps](https://docs.raydium.io/reference/changelog/2026-08-26-launchlab-platform-fee-rate-cap.md): The platform fee_rate ceiling moves to 500 bps on both the create and the update path. CreatePlatformConfig was capped at 100 bps and UpdatePlatformConfig at 250 bps; both are now 50000. No account layout, instruction, or error change.
- [2026-08-24 — LaunchLab: Token-2022 quote mints](https://docs.raydium.io/reference/changelog/2026-08-24-launchlab-token2022-quote-mint.md): LaunchLab accepts Token-2022 quote mints across config, pool creation, swaps, fee claims, and CPMM migration. Swap slippage bounds now price the quote-side transfer fee, PoolState.token_program_flag bit1 becomes meaningful, and MigrateToCpswap renames its two token-program accounts.
- [2026-08-17 — LaunchLab: CPMM-only launches and platform config controls](https://docs.raydium.io/reference/changelog/2026-08-17-launchlab-cpmm-only-platform-config.md): LaunchLab makes CPMM mandatory for new launches, consolidates locked LP under the platform, replaces global platform authorization with platform-managed config allowlists, and updates CPMM migration accounts.
- [2026-08-17 — CLMM: restricted-issuer position NFT freezing](https://docs.raydium.io/reference/changelog/2026-08-17-clmm-restricted-position-nft-freeze.md): CLMM conditionally freezes a new position NFT account only when a V2 open path finds an underlying mint whose freeze authority matches the restricted-issuer list.
- [2026-08-17 — CPMM: permissionless creator-fee collection](https://docs.raydium.io/reference/changelog/2026-08-17-cpmm-permissionless-creator-fee-collection.md): CPMM adds a destination-constrained instruction that lets any payer sweep creator fees to the pool creator's canonical ATAs, and delegates Permission PDA creation without delegating revocation.
- [2026-07-30 — CLMM: permissioned multi-pools and limit-order frozen-account guard](https://docs.raydium.io/reference/changelog/2026-07-30-clmm-permissioned-pools.md): Two CLMM program updates: CreatePermissionedPool lets a whitelisted authority create multiple pools per pair via a seed_index folded into the pool PDA, and OpenLimitOrder now takes the output-side accounts to reject orders with a frozen input or output token account.
- [2026-07-22 — AMM v4: remove OpenBook / Serum dependency](https://docs.raydium.io/reference/changelog/2026-07-22-amm-v4-openbook-removal.md): AMM v4 removes its dormant OpenBook/Serum dependency, CPIs, and market-making instructions: v1 Swap/Deposit/Withdraw stay compatible, WithdrawPnl and SetParams are hard-breaking, and several instructions are no longer callable.
- [2026-06-22 — Stable AMM: remove dead OpenBook (market) code](https://docs.raydium.io/reference/changelog/2026-06-22-stable-amm-openbook-cleanup.md): Stable AMM removes its dormant OpenBook market-making accounts and code: smaller Swap/Deposit/Withdraw layouts, a hard-breaking WithdrawPnl change, and a simplified pool-asset formula.
- [2026-05-18 — CLMM: limit orders, single-sided fee, dynamic fee](https://docs.raydium.io/reference/changelog/2026-05-18-clmm-limit-orders.md): Three opt-in, backwards-compatible CLMM capabilities: first-class limit orders, single-sided fee collection, and a volatility-tracking dynamic fee — plus the PoolState reshape and new error codes.
- [2026-04-26 — Initial publication](https://docs.raydium.io/reference/changelog/2026-04-26-initial-publication.md): First public release of the Raydium documentation set.

### Resources

- [Resources](https://docs.raydium.io/resources/index.md): Brand assets, community-built tools, and licensing for Raydium's code, SDK, and documentation.
- [Brand kit](https://docs.raydium.io/resources/brand-kit.md): Logos, colors, typography, and usage rules for representing Raydium in press, integrations, partner content, and dashboards.
- [Community tools](https://docs.raydium.io/resources/community-tools.md): Third-party SDKs, dashboards, bots, and analytics platforms that integrate with Raydium — plus how to submit your own tool for inclusion.
- [License](https://docs.raydium.io/resources/license.md): License terms for Raydium's on-chain programs, the TypeScript SDK, and this documentation. Trademark notes for the Raydium name and logo.

## OpenAPI Specs

- [api-v3](/api-reference/openapi/api-v3.yaml)
- [route-api-v2](/api-reference/openapi/route-api-v2.yaml)
- [perp-api-v1](/api-reference/openapi/perp-api-v1.yaml)
- [launch-mint-v1](/api-reference/openapi/launch-mint-v1.yaml)
- [launch-history-v1](/api-reference/openapi/launch-history-v1.yaml)
- [launch-forum-v1](/api-reference/openapi/launch-forum-v1.yaml)
- [launch-auth-v1](/api-reference/openapi/launch-auth-v1.yaml)
- [dynamic-ipfs-v1](/api-reference/openapi/dynamic-ipfs-v1.yaml)
- [owner-api-v1](/api-reference/openapi/owner-api-v1.yaml)
- [api-v1](/api-reference/openapi/api-v1.yaml)
- [temp-api-v1](/api-reference/openapi/temp-api-v1.yaml)

## Optional

- [raydium.io](https://raydium.io)
- [GitHub](https://github.com/raydium-io)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Chinese (260 pages)](https://docs.raydium.io/_llms/zh.txt): Documentation for Chinese.
- [Traditional Chinese (260 pages)](https://docs.raydium.io/_llms/zh-hant.txt): Documentation for Traditional Chinese.
- [Japanese (260 pages)](https://docs.raydium.io/_llms/ja.txt): Documentation for Japanese.
- [Korean (260 pages)](https://docs.raydium.io/_llms/ko.txt): Documentation for Korean.
- [Russian (260 pages)](https://docs.raydium.io/_llms/ru.txt): Documentation for Russian.
- [Russian / Справочник API (82 pages)](https://docs.raydium.io/_llms/ru/spravochnik-api.txt): Documentation for Russian / Справочник API.
- [Spanish (260 pages)](https://docs.raydium.io/_llms/es.txt): Documentation for Spanish.
- [Spanish / Referencia de API (82 pages)](https://docs.raydium.io/_llms/es/referencia-de-api.txt): Documentation for Spanish / Referencia de API.
- [German (260 pages)](https://docs.raydium.io/_llms/de.txt): Documentation for German.
- [German / API-Referenz (82 pages)](https://docs.raydium.io/_llms/de/api-referenz.txt): Documentation for German / API-Referenz.
- [French (259 pages)](https://docs.raydium.io/_llms/fr.txt): Documentation for French.
- [French / Référence API (82 pages)](https://docs.raydium.io/_llms/fr/reference-api.txt): Documentation for French / Référence API.
- [Portuguese (260 pages)](https://docs.raydium.io/_llms/pt.txt): Documentation for Portuguese.
- [Portuguese / >_ Api Reference (82 pages)](https://docs.raydium.io/_llms/pt/api-reference.txt): Documentation for Portuguese / >_ Api Reference.
- [Turkish (260 pages)](https://docs.raydium.io/_llms/tr.txt): Documentation for Turkish.
- [Turkish / >_ Api Reference (82 pages)](https://docs.raydium.io/_llms/tr/api-reference.txt): Documentation for Turkish / >_ Api Reference.
- [Vietnamese (260 pages)](https://docs.raydium.io/_llms/vi.txt): Documentation for Vietnamese.
- [Indonesian (260 pages)](https://docs.raydium.io/_llms/id.txt): Documentation for Indonesian.
- [Arabic (260 pages)](https://docs.raydium.io/_llms/ar.txt): Documentation for Arabic.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.