API 参考

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

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

查看英文版 →

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

​

服务目录

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

服务	Mainnet 主机	Devnet 主机	功能说明
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	池、代币、配置、链信息——UI 和 SDK 依赖的规范读取 API。
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	服务端交换/流动性交易构建。聚合器的入口点。
Perps API	api-perp-v1.raydium.io	—	Raydium 永续合约前端的设置、资产元数据和 RPC 选择。
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	代币搜索、索引、排行榜、LaunchLab 代币发行的元数据。
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	LaunchLab 池的交易历史和 K 线数据。
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	与 LaunchLab 代币发行相关的评论、话题和 IPFS 上传。需要钱包签名。
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	从钱包签名的消息颁发短期 ray-token JWT。调用论坛 API 需要。
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	NFT 图像/元数据生成器。驱动 CLMM 持仓艺术品和其他链上 NFT 的动态渲染。
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	按钱包查询持仓、余额和可领取奖励。
API v1	api.raydium.io	—	旧版 v1/v2 端点，为尚未迁移到 API v3 的客户端保持可用。
Temp API	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 负载：

{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}

失败时：

{
  "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。

​

相关链接

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