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.
本页内容由 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 访问端点。
ray-token;该值仅在你的浏览器中保存。
速率限制
所有主机都位于 Cloudflare 后端,按源 IP 采用渐进式速率限制。 需要更高限制的集成方应联系 Raydium 团队。超过发布限制的突发请求返回HTTP 429 和 Retry-After 请求头。
响应包装
大多数服务用统一的包装结构封装 JSON 负载:api-v3 返回格式为 { "id", "success", "data" }。pump-* 服务使用 addBorderSuccess / addBorderErr 辅助函数生成相同的结构,msg 仅在错误时填充。查看各服务的介绍页面了解其具体的包装格式。
如何使用本部分
点击左侧导航中的任何端点。你将看到:- HTTP 方法、完整 URL 和基础主机。
- 从 OpenAPI 规范提取的类型的请求参数。
- 一个试用面板,让你设置参数并向 mainnet 发送真实请求(或在有可用的情况下从下拉菜单选择 devnet 服务器)。
- 响应结构,来自代表性的实时响应和源代码的
addBorderSuccess调用点。
sdk-api/typescript-sdk。
相关链接
sdk-api/rest-api— REST 表面的叙述性概述,为首次集成者编写。integration-guides/aggregator— 如何将 Transaction API 与链上池配合使用。reference/program-addresses—api-v3返回的每个程序 ID 都对应其中之一。


