跳转到主要内容

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 自动翻译，所有内容以英文版本为准。查看英文版 →

​
Raydium API v3 是什么？

Raydium API v3 提供了一个 REST 接口，用于查询 Solana 上 Raydium 各个交易场景中的流动性池、代币元数据、农场和链上统计数据。钱包、聚合器、DEX 路由器和交易者都可以使用它来获取规范的池数据、价格信息和历史分析。 该 API 设计用于高吞吐量——响应数据通常有 1-5 分钟的延迟，具体取决于端点的敏感性。所有响应都使用一致的信息信封进行包装。

​
基础地址

环境URL
Mainnethttps://api-v3.raydium.io
Devnethttps://api-v3-devnet.raydium.io

​
响应信封

所有端点都返回一个包含请求元数据和响应负载的 JSON 信封：

​
成功响应

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // 特定端点的数据
  }
}

​
错误响应

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
id 字段是唯一的请求标识符（UUID）。处理 data 前务必检查 success 字段。

​
常见注意事项

​
/pools/info/mint 上的代币对排序

当你查询 /pools/info/mint?mint1=ABC&mint2=XYZ 时，端点会在内部通过按字母顺序排序代币来规范化交易对。如果你需要搜索单个代币，请完全省略 mint2 参数——API 会找到包含该代币的所有池。

​
池类型过滤值

poolType 查询参数接受以下特定枚举值：
  • all — 所有池类型
  • concentrated — 仅 CLMM 池
  • standard — 仅 AMM（恒定乘积）池
  • allFarm — 至少有一个活跃农场的池
  • concentratedFarm — 带有农场的集中流动性池
  • standardFarm — 带有农场的标准池
拼写错误或大小写不匹配会被拒绝。

​
池排序字段值

有效的 poolSortField 值包括：
  • default（按 24h 交易量排序）
  • liquidity（TVL）
  • volume24h、volume7d、volume30d
  • fee24h、fee7d、fee30d
  • apr24h、apr7d、apr30d

​
/pools/info/list-v2 的分页

v2 端点通过 nextPageId 使用基于游标的分页。不透明令牌在响应中返回，必须原样传回。不要尝试构造自己的游标——它编码了 Elasticsearch 状态。

​
页面大小默认值和限制

  • /pools/info/list 和 /pools/info/mint 将 pageSize 限制为 1000。
  • /farms/info/lp 将 pageSize 限制为 100。
  • /pools/info/list-v2 将 size 限制为 1000。
超过限制的请求将被拒绝并返回错误。

​
CLMM 动态费用和限价单配置

两个新端点公开了 CLMM CreateCustomizablePool 流程的校准数据：
  • GET /main/clmm-dynamic-config — DynamicFeeConfig 层级列表（过滤周期、衰减周期、降低因子、最大分子、动态费用控制）。在 enableDynamicFee=true 时，将其中一个的 id 传入 createCustomizablePool。
  • GET /main/clmm-limit-order-config — 每个池的限价单配置：是否启用限价单、最小输入金额以及获得授权处理已成交订单的链下 limit_order_admin 管理员。
每个钱包的限价单数据（未平仓/已成交/已平仓）位于 Temp API；参见 api-reference/temp-api-v1/overview。

​
相关文档

​
使用示例

获取主要统计信息： 
curl -s https://api-v3.raydium.io/main/info | jq .
列出按 TVL 排序的前 10 个池： 
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
获取 SOL-USDC 池： 
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
获取代币价格： 
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
获取 LP 代币的农场池： 
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

​
状态和可用性

Raydium API v3 已在主网上线。关于可用性和事件，请关注 @Raydium。