SDK & API

Reference for Raydium’s TypeScript SDK, REST API, Anchor IDLs, and integration patterns for Rust, Python, and AI tools.

Who this chapter is for

Developers integrating against Raydium from off-chain (TS/JS, Python, backends) or from another Solana program (Rust CPI). Also AI agents and coding-tool integrators — see AI integration.

Want to run something first? Three paste-and-go scripts — swap, deploy CPMM pool, deploy CLMM pool — live in Quick start. Run a real transaction in five minutes, then come back here for the full reference.

Pick your integration path

Five paths to choose from. The right one depends on what’s calling Raydium and how much control you need.

Path	Best for	Latency	Custom logic	Languages
Trade API	Backends, bots, Blinks — anywhere you want a server-built tx	Lowest	Limited (preset routes)	Any
TypeScript SDK	Node/TS apps and frontends needing full builder access	Medium	Full	TS / JS
Python integration	Python backends and ML pipelines	Medium	Full (manual instr build)	Python
Rust CPI	Composing programs that call Raydium from on-chain	N/A (on-chain)	Full + composable	Rust
Anchor IDL	Codegen for languages without first-party support (Go, Kotlin, Swift, …)	Variable	Full	Any with an Anchor codegen tool

If you’re not sure: backends and bots → Trade API; frontends and full-control apps → TypeScript SDK; on-chain composition → Rust CPI.

Chapter contents

TypeScript SDK

@raydium-io/raydium-sdk-v2: installation, initialization, core modules (pool, farm, launch), transaction builders, common pitfalls.

REST API

Public endpoints for pool info, mint info, price, and server-built transactions. Rate limits, caching guidance, versioning.

Trade API

Server-built swap transactions: quote, build, sign, send. The SDK-free integration pattern for backends, bots, and Blinks.

Anchor IDL

Where to find each program’s IDL, how to regenerate clients from it, what to watch for when the IDL is updated.

Rust CPI

Patterns for invoking Raydium programs from another Solana program — account list construction, signer seeds, error handling.

Python integration

solders + solana-py recipes for building Raydium swaps/pool ops from Python. Useful for backends and bots.

AI integration

MCP server, llms.txt index, per-page copy menu, pre-built context files for Claude Code / Cursor / Windsurf and other coding agents.

Version discipline

Every code sample on every page in this chapter has a banner at the top:

SDK:       @raydium-io/raydium-sdk-v2 vX.Y.Z
Program:   see /reference/program-addresses
Cluster:   mainnet-beta
Verified:  YYYY-MM-DD

If you touch a code sample, update the banner.