> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK & API

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

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

  [영문판 보기 →](/sdk-api/index)
</Info>

## 이 장의 대상

오프체인(TS/JS, Python, 백엔드)에서 Raydium과 통합하거나 다른 Solana 프로그램(Rust CPI)에서 호출하는 개발자를 위한 내용입니다. AI 에이전트와 코딩 도구 통합자도 포함됩니다. [AI 통합](/ko/sdk-api/ai-integration)을 참고하세요.

<Info>
  **먼저 실행해 보고 싶으신가요?** 스왑, CPMM 풀 배포, CLMM 풀 배포의 세 가지 엔드-투-엔드 스크립트는 [빠른 시작](/ko/quick-start)에 있습니다. 스왑과 CPMM 스크립트는 복사해서 바로 실행할 수 있는 단일 파일이고, CLMM 흐름은 몇 가지 추가 단계가 필요합니다. 먼저 실제 트랜잭션을 실행한 후 여기로 돌아와 전체 레퍼런스를 확인하세요.
</Info>

## 통합 경로 선택

5가지 경로 중에서 선택할 수 있습니다. 올바른 경로는 Raydium을 호출하는 것이 무엇인지, 그리고 얼마나 많은 제어가 필요한지에 따라 달라집니다.

| 경로 | 최적 사용 사례 | 지연 시간 | 커스텀 로직 | 언어 |
| - | - | - | - | - |
| [Trade API](/ko/sdk-api/trade-api) | 백엔드, 봇, Blink — 서버에서 빌드한 트랜잭션이 필요한 곳 | 최저 | 제한적 (사전 설정된 경로) | 모든 언어 |
| [TypeScript SDK](/ko/sdk-api/typescript-sdk) | 전체 빌더 접근이 필요한 Node/TS 앱과 프론트엔드 | 중간 | 전체 | TS / JS |
| [Python 통합](/ko/sdk-api/python-integration) | Python 백엔드와 ML 파이프라인 | 중간 | 전체 (수동 명령어 빌드) | Python |
| [Rust CPI](/ko/sdk-api/rust-cpi) | Raydium을 온체인에서 호출하는 프로그램 구성 | N/A (온체인) | 전체 + 구성 가능 | Rust |
| [Anchor IDL](/ko/sdk-api/anchor-idl) | 기본 지원이 없는 언어를 위한 코드 생성 (Go, Kotlin, Swift, ...) | 가변 | 전체 | Anchor 코드 생성 도구가 있는 모든 언어 |

확실하지 않으신가요? 백엔드와 봇 → **Trade API**; 프론트엔드와 전체 제어 앱 → **TypeScript SDK**; 온체인 구성 → **Rust CPI**.

## 장의 내용

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/ko/sdk-api/typescript-sdk">
    `@raydium-io/raydium-sdk-v2`: 설치, 초기화, 핵심 모듈 (풀, 팜, 런치), 트랜잭션 빌더, 일반적인 함정.
  </Card>

  <Card title="REST API" icon="cloud" href="/ko/sdk-api/rest-api">
    풀 정보, 민트 정보, 가격, 서버 빌드 트랜잭션을 위한 공개 엔드포인트. 속도 제한, 캐싱 가이드, 버전 관리.
  </Card>

  <Card title="Trade API" icon="right-left" href="/ko/sdk-api/trade-api">
    서버 빌드 스왑 트랜잭션: 견적, 빌드, 서명, 전송. 백엔드, 봇, Blink를 위한 SDK 없는 통합 패턴.
  </Card>

  <Card title="Anchor IDL" icon="file-code" href="/ko/sdk-api/anchor-idl">
    각 프로그램의 IDL을 찾는 위치, IDL에서 클라이언트를 재생성하는 방법, IDL이 업데이트될 때 주의할 사항.
  </Card>

  <Card title="Rust CPI" icon="rust" href="/ko/sdk-api/rust-cpi">
    다른 Solana 프로그램에서 Raydium 프로그램을 호출하는 패턴 — 계정 목록 구성, 서명자 시드, 오류 처리.
  </Card>

  <Card title="Python 통합" icon="python" href="/ko/sdk-api/python-integration">
    Python에서 Raydium 스왑/풀 작업을 빌드하기 위한 `solders` + `solana-py` 레시피. 백엔드와 봇에 유용합니다.
  </Card>

  <Card title="AI 통합" icon="robot" href="/ko/sdk-api/ai-integration">
    MCP 서버, `llms.txt` 인덱스, 페이지별 복사 메뉴, Claude Code / Cursor / Windsurf 및 기타 코딩 에이전트를 위한 사전 빌드된 컨텍스트 파일.
  </Card>
</CardGroup>

## 버전 규칙

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

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

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


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