REST API サーフェス

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.

​

11 個のサービス概要

​

サービスの選択

​

クロスカッティング規約

​

レスポンスエンベロップ

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

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

​

認証

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

​

レート制限

​

キャッシング と一貫性

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

​

エラー形式

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

​

ミントペア引数規約

​

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

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 コーディングエージェント向けのポインタ。