API 參考

Raydium 運營的 HTTP API 完整目錄：資金池數據、交易構建、槓桿交易、LaunchLab 論壇 / 代幣發行 / 歷史 / 認證服務、IPFS 閘道、持倉查詢，以及舊版 Python API。以下端點均開放互動式測試區。

本頁內容由 AI 自動翻譯，所有內容以英文版本為準。

查看英文版 →

本站所有端點都配備 試用 面板，由 Mintlify OpenAPI 測試區提供支援。該測試區在瀏覽器中執行，直接連線到生產環境（或測試網）主機。在發送需要錢包簽名的請求前，請先閱讀身份驗證。

​

服務目錄

Raydium 運營十一個公開的 HTTP 服務。左側導航樹中，每個服務都有其獨立的文件組。

服務	主網主機	測試網主機	功能說明
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	資金池 / 代幣 / 設定 / 鏈資訊 — UI 和 SDK 依賴的標準讀取 API。
交易 API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	伺服器端交換 / 流動性交易構建。聚合器的入口點。
槓桿交易 API	api-perp-v1.raydium.io	—	Raydium 槓桿交易前端的設定、資產元數據、RPC 選擇。
LaunchLab 代幣發行 API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	代幣搜尋、索引、排行榜、LaunchLab 發行的各代幣元數據。
LaunchLab 歷史 API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	LaunchLab 資金池的交易歷史、K 線聚合。
LaunchLab 論壇 API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	與 LaunchLab 發行相關的評論、主題串、IPFS 上傳。需要錢包簽名。
LaunchLab 認證 API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	從錢包簽名的訊息發放短期有效的 ray-token JWT。呼叫論壇 API 時必需。
動態 IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	NFT 圖像 / 元數據再生器。驅動 CLMM 持倉藝術和其他動態狀態決定其外觀的鏈上 NFT。
持倉 API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	逐錢包的持倉、餘額、可領取獎勵。
API v1	api.raydium.io	—	舊版 v1/v2 端點，為未遷移至 API v3 的用戶端保持運行。
臨時 API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	短期特製端點的暫存區。目前提供 CPMM 建立者費用摘要。可能無預告地變更。

​

身份驗證

大多數服務為唯讀，接受匿名請求。包含兩種模式：

• 錢包簽名握手 — launch-auth-v1 需要此方式來鑄造 ray-token，隨後作為 ray-token 標頭被 launch-forum-v1 使用。使用錢包簽名格式為 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 規格拉取的含類型的請求參數。
• 試用 面板，讓你設定參數並向主網（或在可用時從下拉選單選擇測試網伺服器）發送真實請求。
• 回應形狀，來自代表性即時回應和原始碼的 addBorderSuccess 呼叫位點。

如需 SDK 級別的存取 — 用戶端構建交易、批量交換、TypeScript 類型 — 請參閱 sdk-api/typescript-sdk。

​

相關連結

• sdk-api/rest-api — REST 表面的敘述性概述，為首次整合方撰寫。
• integration-guides/aggregator — 如何將交易 API 與鏈上資金池搭配使用。
• reference/program-addresses — api-v3 返回的每個程式 ID 都對應至其中之一。