WEEX API 文件：如何開始使用 WEEX 交易 API

開始使用 WEEX API，首先需要準備兩項內容：WEEX 官方 API 文件，以及依照預計使用功能設定的 API Key。WEEX 為現貨與 USDT-M 合約交易提供 API 資源，文件涵蓋市場資料、帳戶功能、交易操作、REST API 與 WebSocket 連線。

開發者無須驗證即可使用支援的公開端點取得市場資料。帳戶與訂單管理等私有功能則需要 API Key，並須使用已驗證的請求。

設定流程相當簡單：選擇相關的 WEEX API 文件、建立 API Key、設定必要權限、妥善保管憑證，並將應用程式連線至適當的 API 端點。

在哪裡可以找到 WEEX 官方 API 文件？

WEEX 提供專門的 API 文件，涵蓋其支援的產品與介面。API 功能變更時，文件也會隨之更新；各個端點頁面則附有整合時可參考的請求與回應範例。 

Spot V3 文件涵蓋準備流程、API 網域、驗證、市場資料、帳戶功能、訂單功能、WebSocket 連線、速率限制及其他技術要求。

WEEX 將 API 分為公開與私有介面。公開 API 可在無須驗證的情況下取得設定與市場資料。私有 API 涵蓋訂單與帳戶管理等功能，並要求使用已驗證的請求。

整合之前，開發者應先選擇預計使用產品的相關文件，因為現貨與合約的端點及技術要求可能有所不同。

如何建立 WEEX API Key

若要使用 WEEX API 私有功能，首先必須透過 WEEX 帳戶建立 API Key。根據目前的 Spot V3 文件，基本流程如下：

1. 透過網頁平台登入 WEEX。
2. 開啟 API 管理並建立新的 API Key。
3. 設定整合所需的權限。
4. 視設定需要綁定 IP 位址。
5. 妥善保存建立或設定過程中產生的 API 憑證。

目前每個 WEEX 帳戶最多可建立 10 組 API Key。如此一來，使用者可以為不同應用程式或交易設定分別管理 API Key，而不必所有連線都共用同一組 Key。

建立 API Key 時，有三項重要憑證： APIKey 用於在驗證時識別 API 使用者。SecretKey 是用來產生請求簽章的私密金鑰。

Passphrase 由使用者設定，是通過驗證存取所需的一部分。若 Passphrase 遺失，WEEX 表示該密語無法復原，且必須建立新的 API Key。這些憑證應妥善保管，不應與他人分享。

如何設定 WEEX API 權限

新建立的 WEEX Spot API Key 預設具有唯讀權限。這項設定允許該 Key 存取支援的查詢功能，但不會授予執行現貨交易操作的權限。

如果應用程式需要下達或取消現貨訂單，就必須啟用相應的 Spot 權限。

因此，應授予的權限取決於應用程式的用途。若工具僅用於監控餘額、查看交易歷史或分析資訊，維持唯讀即可。若應用程式需要執行現貨訂單，則必須具備 Spot 交易權限。

WEEX 也允許使用者將 API Key 綁定至 IP 位址。官方文件提醒，未限制且未綁定 IP 的 API Key 會帶來額外安全風險，並建議建立 Key 時綁定 IP 位址。

實用的做法是只授予每項整合實際需要的權限，而不要啟用應用程式不會使用的額外存取權限。

如何連線至 WEEX REST API

準備好 API Key 和權限後，即可將應用程式連線至 WEEX REST API。WEEX 提供用於市場資料、帳戶資訊及支援交易操作的 REST API 端點。

公開端點可在無須驗證的情況下取得市場資訊。帳戶與訂單功能等私有端點，則須使用 API 憑證進行驗證，並遵循 WEEX 官方 API 文件所列的簽章要求。

建議先測試公開市場資料請求，再開始使用需要驗證的功能。連線正常後，即可根據 API Key 已啟用的權限使用適當的私有端點。

API 端點與技術要求可能會更新，因此設定整合時，請務必參閱最新的 WEEX API 文件。

如何檢查 WEEX API 連線

開始整合時，簡單的做法是在加入較複雜的交易功能前，先確認應用程式能否與 WEEX API 正常通訊。

由於公開 API 請求不需要驗證，可以先使用這類請求。基本連線正常後，再依照 API Key 所獲授的權限測試已驗證的請求。

如果已驗證的請求失敗，可能需要檢查設定中的幾個部分，包括 API 憑證、權限、請求簽章、時間戳記、API 網域與 IP 限制。

WEEX 要求已驗證的請求使用標準化簽章方法。依據目前的 V3 文件，請求時間戳記以毫秒為單位；若時間戳記與 WEEX API 伺服器時間相差超過 30 秒，請求可能會遭到拒絕。 

逐步測試連線，有助於判斷問題是出在連線、驗證、權限，還是個別請求。

使用 WEEX API 交易前應檢查哪些事項？

使用 WEEX API 交易前，請檢查 API Key 權限，並確認該 Key 僅具有應用程式所需的存取權限。WEEX 也建議將 API Key 綁定至可信任的 IP 位址，並妥善保管 API Key、SecretKey 與 Passphrase。

開發者也應確認目前的 API 速率限制，並妥善處理請求錯誤。超出適用限制可能導致請求遭拒，因此自動化系統應依照官方文件所列的限制進行設計。

正式使用 API 進行交易前，請仔細測試連線、驗證、權限與下單邏輯。如需了解最新的安全要求與速率限制，請參閱目前版本的 WEEX API 文件。

結論

開始使用 WEEX API，需要先選擇適當的官方文件、建立 API Key、設定其權限、妥善保管憑證，並將應用程式連線至相關 API 端點。

開發者可先使用公開 API 請求，再進一步使用需要驗證的帳戶或交易功能。如需查閱目前的端點、驗證要求、權限與速率限制，應以最新的 WEEX API 文件作為主要技術參考資料。

常見問題

1. 在哪裡可以找到 WEEX 官方 API 文件？
WEEX 提供專門的文件，涵蓋其 API 產品、端點、驗證、WebSocket 連線、參數與回應範例。由於 API 功能可能隨時間更新，開發者應使用最新版本。

2. 如何建立 WEEX API Key？
登入 WEEX 網頁平台，開啟 API 管理以建立並設定 API Key。目前每個帳戶最多可建立 10 組 API Key。

3. 建立 WEEX API Key 後，需要保存哪些資訊？
請妥善保存 APIKey、SecretKey 與 Passphrase。遺失的 Passphrase 無法復原，因此若遺失，必須建立新的 API Key。

4. 新的 WEEX API Key 具備哪些權限？
新的 Spot API Key 預設為唯讀。若要執行現貨交易操作，必須啟用相應的 Spot 交易權限。

5. 為什麼我的 WEEX API 請求無法正常運作？
常見原因包括憑證錯誤、權限不足、簽章錯誤、時間戳記差異、IP 限制或速率限制。請根據請求回傳的錯誤，查看官方 WEEX API 文件中的相關章節。