API リファレンス

Raydium が運営する HTTP API カタログ：プールデータ、トランザクション構築、Perps、LaunchLab フォーラム・ミント・履歴・認証サービス、IPFS ゲートウェイ、オーナーポジション、レガシー Python API。以下のエンドポイントはすべてインタラクティブなプレイグラウンドで利用できます。

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

英語版を表示 →

このサイトのすべてのエンドポイントには、Mintlify の OpenAPI プレイグラウンドを搭載した**「Try it」パネル**があります。プレイグラウンドはブラウザ上で実行され、本番環境（またはデブネット）ホストに直接リクエストを送信します。ウォレット署名が必要なリクエストを送信する前に、認証セクションをお読みください。

​

サービス カタログ

Raydium は 11 個の公開 HTTP サービスを運営しています。各サービスは左側のナビゲーションツリーに独立したグループとして文書化されています。

サービス	Mainnet ホスト	Devnet ホスト	機能
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	プール・ミント・設定・チェーン情報 — UI と SDK が依存する標準的な読み取り API。
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 ローンチのミント単位のメタデータ。
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	LaunchLab プール向けのトレード履歴、K線集計。
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 を発行。フォーラム API の呼び出しに必須。
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	NFT 画像・メタデータ再生成。CLMM ポジション アート及び動的状態に見た目が依存する他のオンチェーン NFT を駆動します。
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	ウォレット単位のポジション、残高、請求可能な報酬。
API v1	api.raydium.io	—	レガシー v1/v2 エンドポイント。API v3 に移行していないクライアント向けに稼働中。
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	短期的な特別なエンドポイント用の一時的な置き場。現在 CPMM クリエーター フィー サマリーを公開しています。予告なく変更される可能性があります。

​

認証

ほとんどのサービスは読み取り専用で、匿名リクエストを受け付けています。以下の 2 つのパターンがあります：

• ウォレット署名ハンドシェイク — launch-auth-v1 が ray-token をミントするために必須。その後 launch-forum-v1 により ray-token ヘッダーとして搬送されます。ウォレットで time:<unix-seconds> 形式の Solana ed25519 メッセージに署名し、署名とウォレット アドレスを launch-auth-v1 の /request-token に送信して JWT を受け取ります。その後、続くフォーラム呼び出しで ray-token リクエスト ヘッダーとして渡します。
• 認証なし — その他すべてのサービス。信頼できる呼び出し元（Raydium UI、インテグレーター）が HTTPS 経由でエンドポイントに直接アクセスします。

Mintlify プレイグラウンドでは、フォーラム リクエストを送信する前に認証パネルに ray-token を貼り付けることができます。この値はブラウザ内にのみ保持されます。

​

レート制限

すべてのホストは Cloudflare の背後にあり、送信元 IP ごとに段階的なレート制限が実装されています。

より高い制限が必要なインテグレーターは、Raydium チームに連絡してください。公開制限を超えたバースト リクエストは HTTP 429 で Retry-After ヘッダー付きで返されます。

​

レスポンス エンベロープ

ほとんどのサービスは JSON ペイロードを統一されたエンベロープでラップします：

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

失敗時：

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

api-v3 はエンベロープを { "id", "success", "data" } で返します。pump-* サービスは addBorderSuccess / addBorderErr ヘルパーを使用して同じ形式を生成し、msg はエラー時のみ入力されます。各サービスの紹介ページで使用している正確なエンベロープを確認してください。

​

このセクションの使い方

左側のナビゲーションでエンドポイントをクリックします。以下の内容が表示されます：

• HTTP メソッド、完全な URL、ベース ホスト。
• OpenAPI 仕様から取得した型情報を含むリクエスト パラメータ。
• Mainnet（または利用可能な場合はドロップダウンから Devnet サーバーを選択）へのリアルリクエスト送信ができる**「Try it」パネル**。
• レスポンス形式（代表的なライブレスポンスとソースコードの addBorderSuccess コールサイトから取得）。

SDK レベルのアクセス（クライアント側でのトランザクション構築、スワップのバッチ処理、TypeScript 型）については、sdk-api/typescript-sdkを参照してください。

​

関連リンク

• sdk-api/rest-api — 初めてのインテグレーター向けに記述された REST サーフェスのナラティブ概要。
• integration-guides/aggregator — Transaction API をオンチェーン プールと組み合わせて使用する方法。
• reference/program-addresses — api-v3 が返すすべてのプログラム ID はこれらのいずれかに解決されます。