> ## 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、后端）或另一个 Solana 程序（Rust CPI）集成 Raydium 的开发者。同时也适合 AI 代理和编码工具集成方——见 [AI 集成](/zh/sdk-api/ai-integration)。

<Info>
  **想先运行些东西？** 三个开箱即用的脚本——交易、部署 CPMM 池、部署 CLMM 池——位于 [快速开始](/zh/quick-start)。五分钟内运行真实交易，然后回到这里查看完整参考。
</Info>

## 选择你的集成方式

有五条路线可选。正确的选择取决于什么在调用 Raydium 以及你需要多少控制权。

| 路线                                           | 最适合                                 | 延迟      | 自定义逻辑      | 语言                   |
| -------------------------------------------- | ----------------------------------- | ------- | ---------- | -------------------- |
| [Trade API](/zh/sdk-api/trade-api)           | 后端、机器人、Blinks——任何需要服务器构建交易的地方       | 最低      | 受限（预设路由）   | 任何                   |
| [TypeScript SDK](/zh/sdk-api/typescript-sdk) | 需要完整构建器访问的 Node/TS 应用和前端            | 中等      | 完整         | TS / JS              |
| [Python 集成](/zh/sdk-api/python-integration)  | Python 后端和 ML 管道                    | 中等      | 完整（手动指令构建） | Python               |
| [Rust CPI](/zh/sdk-api/rust-cpi)             | 调用 Raydium 的链上程序组合                  | N/A（链上） | 完整 + 可组合   | Rust                 |
| [Anchor IDL](/zh/sdk-api/anchor-idl)         | 针对没有官方支持的语言的代码生成（Go、Kotlin、Swift 等） | 可变      | 完整         | 任何带 Anchor 代码生成工具的语言 |

如果你不确定：后端和机器人 → **Trade API**；前端和完整控制应用 → **TypeScript SDK**；链上组合 → **Rust CPI**。

## 本章内容

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/zh/sdk-api/typescript-sdk">
    `@raydium-io/raydium-sdk-v2`：安装、初始化、核心模块（池、农场、发起）、交易构建器、常见陷阱。
  </Card>

  <Card title="REST API" icon="cloud" href="/zh/sdk-api/rest-api">
    池信息、代币信息、价格和服务器构建交易的公共端点。速率限制、缓存指南、版本控制。
  </Card>

  <Card title="Trade API" icon="right-left" href="/zh/sdk-api/trade-api">
    服务器构建的交易：报价、构建、签名、发送。适用于后端、机器人和 Blinks 的无 SDK 集成模式。
  </Card>

  <Card title="Anchor IDL" icon="file-code" href="/zh/sdk-api/anchor-idl">
    查找每个程序的 IDL、如何从其重新生成客户端、IDL 更新时要注意的事项。
  </Card>

  <Card title="Rust CPI" icon="rust" href="/zh/sdk-api/rust-cpi">
    从另一个 Solana 程序调用 Raydium 程序的模式——账户列表构造、签名者 seed、错误处理。
  </Card>

  <Card title="Python 集成" icon="python" href="/zh/sdk-api/python-integration">
    `solders` + `solana-py` 配方，用于从 Python 构建 Raydium 交易/池操作。对后端和机器人有用。
  </Card>

  <Card title="AI 集成" icon="robot" href="/zh/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
```

如果你修改代码示例，更新横幅。