REST API 表面

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.

​

一览十一个服务

​

选择服务

​

跨服务约定

​

响应信封

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

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

​

认证

• 无认证 —除 Forum 外的每个服务。通过 HTTPS 匿名访问它们。
• 钱包签名握手 — LaunchLab Forum API 必需。使用你的钱包签署形式为 time:<unix-seconds> 的 Solana ed25519 消息，将签名 + 钱包地址发送到 LaunchLab Auth API /request-token，获取 JWT，并在后续 forum 调用中将其作为 ray-token 请求头传递。

​

速率限制

​

缓存和一致性

• 大多数 API v3 读端点在边缘缓存 5–60 秒；具体的 TTL 在每个端点的 API Reference 页面上注明。
• 缓存由索引器在观察到的接触程序事件时失效。
• 在大型重组或拥塞期间，API 的视图和链上状态之间可能有 1–2 slot 的差异。SDK 和直接 RPC 读取总是更及时的——如果客户端即将签署交易，通过 RPC 重新获取相关账户，永远不要盲目信任 API 值。

​

错误格式

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}

​

Mint 对参数约定

​

推荐的客户端模式

1. 一次补充，懒惰刷新。 在应用加载时拉取 GET /main/info 和 GET /mint/list（均在 API v3 上），并以 1 小时 TTL 本地缓存。两者都是大量边缘缓存的，很少改变。
2. 在端点允许的地方进行批量操作。 GET /pools/info/ids?ids=… 接受逗号分隔列表——在一个请求中获取十个流动性池，而不是十个请求。
3. 避免热路径价格获取。 GET /mint/price 对 UI 渲染很好；永远不要在机器人中循环它。对于交易机器人，运行索引器或直接订阅 RPC programSubscribe 事件。
4. 镜像或代理以获得高吞吐量。 超过发布速率限制上限的任何内容都应从你自己的缓存层提供，而不是直接离开公共主机。对 transaction-v1 有持续 >120 req/min 的聚合器应该运行自己的报价 / 路由引擎。
5. 在签署前重新获取。 API 响应可能有 5–60 秒陈旧。为了在签署时获得实际正确的流动性池快照，通过 SDK 或直接 RPC getMultipleAccounts 调用重新读取相关账户。将 API 值视为查询提示，而不是结算源。
6. 使用 Transaction API 进行低摩擦集成。 如果你不想在客户端捆绑 SDK（移动原生、受限环境中的机器人），Transaction API 将为用户签署返回 base64 编码的版本化交易。它返回的 swapResponse 嵌入报价——将其视为对约 30 秒有效。

​

接下来去哪里

• 端点参考（交互式） — API Reference。每个服务都有自己的组；点击任何端点查看参数、响应形状、代码示例和 Try-it 面板。
• TypeScript SDK — sdk-api/typescript-sdk。SDK 在内部为几个路径消费 API v3；对于交易构造，它总是从 RPC 重新获取状态，永远不会盲目信任 API。
• Trade API 集成 — integration-guides/aggregator。将 Raydium 流动性连接到多 DEX 聚合器的模式。
• AI 友好文档 — sdk-api/ai-integration。需要调用这些 API 的 AI 编码代理的指针。