> ## 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.

# API 参考

> Raydium 全部公开 HTTP API 的完整目录：池数据、交易构建、永续合约、LaunchLab 论坛/代币发行/历史/认证服务、IPFS 网关、持仓查询以及旧版 Python API。下列端点均支持交互式测试面板。

<Info>
  **本页内容由 AI 自动翻译，所有内容以英文版本为准。**

  [查看英文版 →](/api-reference/index)
</Info>

<Info>
  本网站上的每个端点都配备了由 Mintlify OpenAPI 测试面板驱动的**试用**功能。测试面板在你的浏览器中运行，直接连接到生产（或 devnet）服务器。在发送需要钱包签名的请求之前，请先阅读[认证](#authentication)。
</Info>

## 服务目录

Raydium 运营 11 个公开 HTTP 服务。每个服务都在左侧导航树中单独记录。

| 服务                                                                    | Mainnet 主机                     | Devnet 主机                             | 功能说明                                           |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | ---------------------------------------------- |
| [API v3](/zh/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | 池、代币、配置、链信息——UI 和 SDK 依赖的规范读取 API。             |
| [Transaction API](/zh/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | 服务端交换/流动性交易构建。聚合器的入口点。                         |
| [Perps API](/zh/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | Raydium 永续合约前端的设置、资产元数据和 RPC 选择。               |
| [LaunchLab Mint API](/zh/api-reference/launch-mint-v1/overview)       | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | 代币搜索、索引、排行榜、LaunchLab 代币发行的元数据。                |
| [LaunchLab History API](/zh/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | LaunchLab 池的交易历史和 K 线数据。                       |
| [LaunchLab Forum API](/zh/api-reference/launch-forum-v1/overview)     | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | 与 LaunchLab 代币发行相关的评论、话题和 IPFS 上传。需要钱包签名。      |
| [LaunchLab Auth API](/zh/api-reference/launch-auth-v1/overview)       | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | 从钱包签名的消息颁发短期 `ray-token` JWT。调用论坛 API 需要。      |
| [Dynamic IPFS API](/zh/api-reference/dynamic-ipfs-v1/overview)        | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | NFT 图像/元数据生成器。驱动 CLMM 持仓艺术品和其他链上 NFT 的动态渲染。    |
| [Owner API](/zh/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | 按钱包查询持仓、余额和可领取奖励。                              |
| [API v1](/zh/api-reference/api-v1/overview)                           | `api.raydium.io`               | —                                     | 旧版 v1/v2 端点，为尚未迁移到 API v3 的客户端保持可用。            |
| [Temp API](/zh/api-reference/temp-api-v1/overview)                    | `temp-api-v1.raydium.io`       | `temp-api-v1-devnet.raydium.io`       | 临时存放区，用于短期专用端点。目前提供 CPMM 创作者费用汇总。随时可能变更，不另行通知。 |

## 认证

大多数服务是只读的，支持匿名请求。出现两种认证模式：

* **钱包签名握手** — `launch-auth-v1` 需要此方式来颁发 `ray-token`，然后由 `launch-forum-v1` 通过 `ray-token` 请求头传递。使用你的钱包对格式为 `time:<unix-seconds>` 的 Solana ed25519 消息签名，将签名和钱包地址发送到 `launch-auth-v1` 的 `/request-token` 端点，收到 JWT 后，在后续论坛调用中将其作为 `ray-token` 请求头传递。
* **无认证** — 所有其他服务。受信任的调用者（Raydium UI、集成方）直接通过 HTTPS 访问端点。

Mintlify 测试面板允许你在发送论坛请求前在认证面板中粘贴 `ray-token`；该值仅在你的浏览器中保存。

## 速率限制

所有主机都位于 Cloudflare 后端，按源 IP 采用渐进式速率限制。

需要更高限制的集成方应联系 Raydium 团队。超过发布限制的突发请求返回 `HTTP 429` 和 `Retry-After` 请求头。

## 响应包装

大多数服务用统一的包装结构封装 JSON 负载：

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
```

失败时：

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": false,
  "msg": "human-readable error string",
  "data": null
}
```

`api-v3` 返回格式为 `{ "id", "success", "data" }`。pump-\* 服务使用 `addBorderSuccess` / `addBorderErr` 辅助函数生成相同的结构，`msg` 仅在错误时填充。查看各服务的介绍页面了解其具体的包装格式。

## 如何使用本部分

点击左侧导航中的任何端点。你将看到：

* HTTP 方法、完整 URL 和基础主机。
* 从 OpenAPI 规范提取的类型的请求参数。
* 一个**试用**面板，让你设置参数并向 mainnet 发送真实请求（或在有可用的情况下从下拉菜单选择 devnet 服务器）。
* 响应结构，来自代表性的实时响应和源代码的 `addBorderSuccess` 调用点。

有关 SDK 级别的访问——客户端交易构建、批量交换、TypeScript 类型——请参阅 [`sdk-api/typescript-sdk`](/zh/sdk-api/typescript-sdk)。

## 相关链接

* [`sdk-api/rest-api`](/zh/sdk-api/rest-api) — REST 表面的叙述性概述，为首次集成者编写。
* [`integration-guides/aggregator`](/zh/integration-guides/aggregator) — 如何将 Transaction API 与链上池配合使用。
* [`reference/program-addresses`](/zh/reference/program-addresses) — `api-v3` 返回的每个程序 ID 都对应其中之一。