SDK & API

Raydium의 TypeScript SDK, REST API, Anchor IDL, 그리고 Rust, Python, AI 도구를 위한 통합 패턴 레퍼런스입니다.

이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.

영문판 보기 →

​

대상 개발자

오프체인(TS/JS, Python, 백엔드)에서 또는 다른 Solana 프로그램(Rust CPI)에서 Raydium과 통합하는 개발자들입니다. 또한 AI 에이전트 및 코딩 도구 통합자들도 포함됩니다. AI 통합을 참고하세요.

먼저 실행해 보고 싶으신가요? 복사해서 바로 실행할 수 있는 세 가지 스크립트(스왑, CPMM 풀 배포, CLMM 풀 배포)가 빠른 시작에 있습니다. 5분 안에 실제 트랜잭션을 실행한 후 여기로 돌아와서 전체 레퍼런스를 확인하세요.

​

통합 경로 선택하기

5가지 경로 중에서 선택할 수 있습니다. 올바른 경로는 무엇이 Raydium을 호출하고 얼마나 많은 제어 권한이 필요한지에 따라 결정됩니다.

경로	최적 사용처	지연 시간	커스텀 로직	언어
Trade API	백엔드, 봇, Blinks — 서버 빌드 tx가 필요한 곳	최소	제한됨 (사전 정의된 경로)	모든 언어
TypeScript SDK	전체 빌더 액세스가 필요한 Node/TS 앱과 프론트엔드	중간	전체	TS / JS
Python 통합	Python 백엔드 및 ML 파이프라인	중간	전체 (수동 인스트럭션 빌드)	Python
Rust CPI	Raydium을 온체인에서 호출하는 프로그램 조합	해당 없음 (온체인)	전체 + 조합 가능	Rust
Anchor IDL	자체 지원 언어가 없는 언어(Go, Kotlin, Swift, …)를 위한 코드젠	변동	전체	Anchor 코드젠 도구가 있는 모든 언어

확실하지 않으신가요? 백엔드 및 봇 → Trade API, 프론트엔드 및 전체 제어 앱 → TypeScript SDK, 온체인 조합 → Rust CPI를 선택하세요.

​

챕터 구성

TypeScript SDK

@raydium-io/raydium-sdk-v2: 설치, 초기화, 핵심 모듈(풀, 팜, 런치), 트랜잭션 빌더, 일반적인 주의사항입니다.

REST API

풀 정보, 민트 정보, 가격 및 서버 빌드 트랜잭션을 위한 공개 엔드포인트입니다. 요청 제한, 캐싱 가이드, 버전 관리입니다.

Trade API

서버 빌드 스왑 트랜잭션: 견적, 빌드, 서명, 전송입니다. 백엔드, 봇, Blinks를 위한 SDK 없는 통합 패턴입니다.

Anchor IDL

각 프로그램의 IDL을 찾을 수 있는 위치, IDL에서 클라이언트를 재생성하는 방법, IDL이 업데이트될 때 주의할 사항입니다.

Rust CPI

다른 Solana 프로그램에서 Raydium 프로그램을 호출하기 위한 패턴 — 어카운트 목록 구성, 서명자 시드, 에러 처리입니다.

Python 통합

Python에서 Raydium 스왑/풀 작업을 구축하기 위한 solders + solana-py 레시피입니다. 백엔드 및 봇에 유용합니다.

AI 통합

MCP 서버, llms.txt 인덱스, 페이지별 복사 메뉴, Claude Code/Cursor/Windsurf 및 기타 코딩 에이전트용 사전 빌드 컨텍스트 파일입니다.

​

버전 관리 규칙

이 챕터의 모든 페이지의 모든 코드 샘플 상단에는 배너가 있습니다.

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

코드 샘플을 수정하면 배너를 업데이트하세요.