> ## 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.

# API 參考

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

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

  [查看英文版 →](/api-reference/index)
</Info>

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

## 服務目錄

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

| 服務                                                                    | 主網主機                           | 測試網主機                                 | 功能說明                                             |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | ------------------------------------------------ |
| [API v3](/zh-Hant/api-reference/api-v3/overview)                      | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | 資金池 / 代幣 / 設定 / 鏈資訊 — UI 和 SDK 依賴的標準讀取 API。      |
| [交易 API](/zh-Hant/api-reference/route-api-v2/overview)                | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | 伺服器端交換 / 流動性交易構建。聚合器的入口點。                        |
| [槓桿交易 API](/zh-Hant/api-reference/perp-api-v1/overview)               | `api-perp-v1.raydium.io`       | —                                     | Raydium 槓桿交易前端的設定、資產元數據、RPC 選擇。                  |
| [LaunchLab 代幣發行 API](/zh-Hant/api-reference/launch-mint-v1/overview)  | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | 代幣搜尋、索引、排行榜、LaunchLab 發行的各代幣元數據。                 |
| [LaunchLab 歷史 API](/zh-Hant/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | LaunchLab 資金池的交易歷史、K 線聚合。                        |
| [LaunchLab 論壇 API](/zh-Hant/api-reference/launch-forum-v1/overview)   | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | 與 LaunchLab 發行相關的評論、主題串、IPFS 上傳。需要錢包簽名。          |
| [LaunchLab 認證 API](/zh-Hant/api-reference/launch-auth-v1/overview)    | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | 從錢包簽名的訊息發放短期有效的 `ray-token` JWT。呼叫論壇 API 時必需。    |
| [動態 IPFS API](/zh-Hant/api-reference/dynamic-ipfs-v1/overview)        | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | NFT 圖像 / 元數據再生器。驅動 CLMM 持倉藝術和其他動態狀態決定其外觀的鏈上 NFT。 |
| [持倉 API](/zh-Hant/api-reference/owner-api-v1/overview)                | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | 逐錢包的持倉、餘額、可領取獎勵。                                 |
| [API v1](/zh-Hant/api-reference/api-v1/overview)                      | `api.raydium.io`               | —                                     | 舊版 v1/v2 端點，為未遷移至 API v3 的用戶端保持運行。               |
| [臨時 API](/zh-Hant/api-reference/temp-api-v1/overview)                 | `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 有效負載包裝在統一封件中：

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
```

失敗時：

```json theme={null}
{
  "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`](/zh-Hant/sdk-api/typescript-sdk)。

## 相關連結

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