REST API サーフェス

Raydium の 11 個の公開 HTTP サービスの概要 — 各サービスの役割、共通する規約（レスポンスエンベロップ、認証、レート制限、キャッシング）、および統合に適したサービスの選び方。

このページは AI による自動翻訳です。すべての内容は英語版を正とします。

英語版を表示 →

エンドポイント詳細ドキュメントは API Reference タブに掲載されています。 各エンドポイントには Mintlify の OpenAPI プレイグラウンドで動作する対話的な Try it パネルがあり、パラメータをブラウザで入力してメインネット（またはデブネット、利用可能な場所）に直接リクエストを送信できます。このページは 物語的な補足: どのサービスが存在し、どれをいつ使用するか、およびすべてのサービスで共通する規約です。「GET /pools/info/ids は何を受け入れるのか」を探している場合は API Reference をクリックしてください。「どのサービスを統合すべきか」を探している場合は以下をお読みください。

​

11 個のサービス概要

Raydium は 11 個の公開 HTTP サービスを運用しています。各サービスは API Reference タブで独自のグループとしてドキュメント化されており、対話的プレイグラウンドを支える OpenAPI 仕様があります。

サービス	メインネットホスト	デブネットホスト	提供内容
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	正規プール・ミント・設定・チェーン情報読み取り API。UI とほとんどの統合者向けのデフォルトエントリーポイント。
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	サーバー側スワップトランザクション構築。
Perps API	api-perp-v1.raydium.io	—	Raydium Perps フロントエンド向けの設定、アセットメタデータ、RPC 選択。
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	トークン検索、インデックス、リーダーボード、ミント単位のメタデータ。
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	LaunchLab プール向けのトレード履歴と OHLC ローソク足集計。
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	LaunchLab ローンチ上のコメントスレッドと IPFS アップロード。ウォレット署名必須。
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	ウォレット署名メッセージから短命な ray-token JWT をミント。Forum 向けに必須。
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	ダイナミック NFT（CLMM ポジションなど）向けのイメージ・メタデータ再生成。
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	ウォレット単位のポジション、残高、請求可能報酬。
API v1（レガシー）	api.raydium.io	—	API v3 に移行していないクライアント向けに保持されるレガシー /v1 および /v2 パス。
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	短命なカスタムエンドポイント用ホルダー。サーフェスは予告なく変更できます。

バージョン管理は v3・v1 サービスのホスト名に含まれており、パスレベルのバージョン管理はさらにありません。破壊的変更は重複期間を持つ新しいホストとしてリリースされます。チームは v3 → v4 移行時に最低 6 ヶ月の重複期間を公に約束しています。

​

サービスの選択

目的	使用するサービス
プールメタデータ、価格、APR、フィー設定を読む	API v3
ミントメタデータ（名前、シンボル、ロゴ、デシマル、リスクタグ）を読む	API v3 /mint/list, /mint/price
スワップ・流動性追加・流動性削除トランザクションをサーバー側で構築	Transaction API
ウォレットのポジション（LP トークン、CLMM ポジション、ファームステーク）を表示	Owner API
LaunchLab トークンを検索、リーダーボードを閲覧、ミント単位メタデータを取得	LaunchLab Mint API
LaunchLab プール向けローソク足チャートをレンダリング	LaunchLab History API
LaunchLab ローンチのコメントを投稿または読む	LaunchLab Auth API → ray-token → LaunchLab Forum API
CLMM ポジション NFT イメージをレンダリング	Dynamic IPFS API
Perps UI 向けの先物マーケット設定またはアセットリストを表示	Perps API
パスプレフィックス付き v1/v2 クライアントとの互換性を維持	API v1（レガシー）

​

クロスカッティング規約

​

レスポンスエンベロップ

IPFS を除くすべてのサービスは同じ JSON エンベロップを返します：

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

失敗時：

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

一部のサービスは追加で error.code 整数も含みます（API v3 はこれをマイナーバージョン間で安定したエラー識別子として使用します）。正確な形式については各サービスの概要ページを参照してください。

​

認証

2 つのパターンがあります：

• 認証なし — Forum を除くすべてのサービス。HTTPS 上で匿名でアクセスします。
• ウォレット署名ハンドシェイク — LaunchLab Forum API で必須。time:<unix-seconds> 形式の Solana ed25519 メッセージをウォレットで署名し、署名 + ウォレットアドレスを LaunchLab Auth API の /request-token に送信し、JWT を受け取ります。その後の Forum コールで ray-token リクエストヘッダーとして渡します。

Mintlify プレイグラウンドは Forum リクエスト送信前に認証パネルで ray-token を受け入れます。値はブラウザ内にのみ保持されます。

​

レート制限

すべてのホストは Cloudflare の背後にあり、ソース IP ごとに段階的なレート制限が適用されます。統合者向けの公開ガイダンス：

公開制限を超えるバーストは HTTP 429 と Retry-After ヘッダーを返します。より高い制限が必要なアグリゲータまたはボットは、公開ホストをハンマリングするのではなく Raydium チームに連絡すべきです。オンチェーンプログラム ID に対して独自のインデクサーを実行することも、読み取り集約型ワークロード向けのオプションです。

​

キャッシング と一貫性

• ほとんどの API v3 読み取りエンドポイントはエッジで 5～60 秒キャッシュされます。具体的な TTL は各エンドポイントの API Reference ページに記載されています。
• キャッシュはインデクサーがプログラムに接触するイベントを観察する時に無効化されます。
• 大規模な再編成または混雑時には、API のビューとオンチェーン状態の間に 1～2 スロットの相違が生じる可能性があります。SDK と直接 RPC 読み取りは常により現在のものです — クライアントがトランザクションに署名しようとしている場合、関連アカウントを RPC 経由で再取得し、API 値を盲目的に信頼しないでください。

​

エラー形式

エラーは同じエンベロップ（success: false、入力済み msg）と共に HTTP 4xx/5xx で返されます。API v3 は追加で安定した error.code を含みます：

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

error.code はマイナー API バージョン間で安定しています。クライアントロジックで主要なシグナルとして扱い、msg を人間が読める表面として扱います。

​

ミントペア引数規約

多くの API v3 エンドポイントは mint1=…&mint2=… を受け入れ、mint1 < mint2（昇順公開鍵バイト順）を要求します。これは API が呼び出し元の推奨引数順序に関わらず同じ正規プールを返すためです。URL を構築する前にクライアント側の 2 つのミントをソートしてください — API Reference のエンドポイント詳細ドキュメントは適用される場所でこの制約を繰り返しています。

​

推奨クライアントパターン

1. 1 回ハイドレートし、遅延リフレッシュ。 アプリロード時に GET /main/info と GET /mint/list（両方 API v3）をプルし、1 時間 TTL でローカルキャッシュします。両方とも大量にエッジキャッシュされ、ほとんど変更されません。
2. エンドポイントが許可する場合はバルク操作。 GET /pools/info/ids?ids=… はカンマ区切りリストを受け入れます — 10 個のリクエストではなく 1 つのリクエストで 10 個のプールをフェッチします。
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 コーディングエージェント向けのポインタ。