跳转到主要内容

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

相关链接