> ## 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.

# Raydium API v3

> 用于查询 Solana 上 Raydium 交易对、代币、农场和链上数据的 REST API

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

  [查看英文版 →](/api-reference/api-v3/overview)
</Info>

## Raydium API v3 是什么？

Raydium API v3 提供了一个 REST 接口，用于查询 Solana 上 Raydium 各个交易场景中的流动性池、代币元数据、农场和链上统计数据。钱包、聚合器、DEX 路由器和交易者都可以使用它来获取规范的池数据、价格信息和历史分析。

该 API 设计用于高吞吐量——响应数据通常有 1-5 分钟的延迟，具体取决于端点的敏感性。所有响应都使用一致的信息信封进行包装。

## 基础地址

| 环境          | URL                                |
| ----------- | ---------------------------------- |
| **Mainnet** | `https://api-v3.raydium.io`        |
| **Devnet**  | `https://api-v3-devnet.raydium.io` |

## 响应信封

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

### 成功响应

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // 特定端点的数据
  }
}
```

### 错误响应

```json theme={null}
{
  "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`](/zh/api-reference/temp-api-v1/overview)。

## 相关文档

* [REST API 概览](/zh/sdk-api/rest-api)
* [API 参考](/zh/api-reference)
* [聚合器集成指南](/zh/integration-guides/aggregator)

## 使用示例

**获取主要统计信息：**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**列出按 TVL 排序的前 10 个池：**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
```

**获取 SOL-USDC 池：**

```bash theme={null}
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 .
```

**获取代币价格：**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
```

**获取 LP 代币的农场池：**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .
```

## 状态和可用性

Raydium API v3 已在主网上线。关于可用性和事件，请关注 [@Raydium](https://x.com/Raydium)。