> ## 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は、Solana上のRaydiumトレーディングベニューのリクイディティプール、トークンメタデータ、ファーム、チェーン統計をクエリするためのRESTインターフェースを提供します。ウォレット、アグリゲーター、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": {
    // Endpoint-specific 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` — 少なくとも1つのアクティブなファームを持つプール
* `concentratedFarm` — ファームを持つコンセントレーティッドプール
* `standardFarm` — ファームを持つスタンダードプール

タイプミスまたは大文字小文字の不一致は拒否されます。

### プールソートフィールド値

有効な`poolSortField`値は：

* `default`（24時間ボリュームでソート）
* `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ダイナミックフィーおよびリミットオーダー設定

2つの新しいエンドポイントは、CLMM `CreateCustomizablePool`フロー用のキャリブレーションデータを公開します：

* `GET /main/clmm-dynamic-config` — `DynamicFeeConfig`ティアのリスト（フィルター期間、減衰期間、削減係数、最大分子、ダイナミックフィー制御）。`enableDynamicFee=true`の場合、これらの1つの`id`を`createCustomizablePool`に渡します。
* `GET /main/clmm-limit-order-config` — プールごとのリミットオーダー設定：リミットオーダーが有効かどうか、最小入力額、および入力されたオーダーを決済する権限を持つオフチェーン`limit_order_admin`キーパー。

ウォレットごとのリミットオーダーデータ（開く/入力された/クローズ）はTemp APIにあります。[`api-reference/temp-api-v1/overview`](/ja/api-reference/temp-api-v1/overview)を参照してください。

## 関連ドキュメント

* [REST APIの概要](/ja/sdk-api/rest-api)
* [APIリファレンス](/ja/api-reference)
* [アグリゲーター向けインテグレーションガイド](/ja/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)をフォローしてください。