WEEX API 金鑰設定：如何安全連接第三方平台

若要將第三方平台連接至 WEEX，請前往「帳戶」中的「API 管理」建立 WEEX API 金鑰，僅授予平台所需的權限，然後將 API 金鑰、密鑰和通行口令貼到平台上。如果該平台是已註冊的 WEEX 經紀商，按一下「使用 WEEX 登入」按鈕即可完成相同操作，完全不必自行處理金鑰。本指南將介紹這兩種方式、安全地測試首筆訂單、最常遇到的錯誤，以及決定金鑰外洩後可能造成多大損失的安全設定。步驟和限制資訊截至 2026 年 10 月 7 日。

快速連接或手動設定 WEEX API 金鑰：該選哪種方式

平台提供快速連接時就使用快速連接，其他情況則使用手動金鑰。

快速連接是 WEEX 的 OAuth 授權功能，於 2026 年 8 月 3 日宣布推出。你在合作平台上按一下「使用 WEEX 登入」，接著進入 WEEX 授權頁面、檢查權限（交易和讀取權限已預先設定），然後確認。WEEX 隨即產生 API 金鑰並傳送至平台的後端，你不會看到或複製金鑰。WEEX 表示，整個流程需要低於10秒。

有兩點需要注意。授權頁面位於 www.weex.com，核准任何操作前請先確認網址列中的網址。此外，WEEX 的 OAuth 規則規定，每位使用者在每個第三方平台只能建立一組金鑰，因此若要重新連結同一平台，必須先刪除舊金鑰。

手動金鑰適用於任何支援 WEEX 的軟體，包括非經紀商的工具，而且你可以完全掌控權限和 IP 綁定設定。

逐步建立 WEEX API 金鑰

1. 在網頁版 WEEX 登入。前往「帳戶」，再進入「API 管理」，然後選擇「建立 API 金鑰」。WEEX API頁面上也有「建立 API」按鈕，點選後會開啟相同畫面。
2. 以金鑰所屬的平台名稱為金鑰命名。
3. 設定僅包含字母和數字的通行口令。WEEX 常見問題指出，不接受特殊字元。通行口令之後無法找回或更改。
4. 選擇權限。新金鑰預設為唯讀。只有在平台會於相應市場下單時，才新增現貨或合約權限。這兩項交易權限彼此獨立，因此合約交易機器人不需要現貨存取權限。
5. 如果平台有公布連線使用的 IP 位址，請綁定這些 IP 位址。
6. 完成安全驗證。
7. 複製 API 金鑰、密鑰和通行口令，並妥善保存。HaasOnline 和 KoinX 的設定指南都提醒，密鑰只會顯示一次。

有三項限制值得留意。根據 WEEX 的整合準備指南，每個帳戶最多可建立 10 組 API 金鑰。新建或修改的金鑰大約需要 15 分鐘才會在所有地方生效。此外，KoinX 指南指出，WEEX 可能會要求填寫 API 啟用問卷，並在金鑰生效前寄送確認電子郵件，因此金鑰在最初幾小時無法使用，不一定代表設定有誤。

綁定金鑰並下第一筆訂單

不同平台對這三項資料的標示方式各不相同。HaasOnline 是一個典型例子，它於 2026 年 8 月 22 日新增 WEEX：開啟「交易所帳戶」，選擇 WEEX 現貨或合約，將 API 金鑰填入公開金鑰欄位、將密鑰填入私密金鑰欄位，再輸入通行口令，然後按下平台的金鑰測試按鈕。「存取金鑰」和「公開金鑰」指的都是 API 金鑰。

讓交易策略開始運作前，先透過平台手動下一筆訂單：

1. 選擇流動性高的交易對，並輸入平台允許的最小數量，以限價單形式下單，價格設定在遠離目前市價的位置。
2. 確認該訂單有顯示在 WEEX 上的未成交訂單中。
3. 在平台取消訂單，並確認訂單已從 WEEX 消失。

這一來一回可以確認金鑰、權限和交易對映射都正常，而且不會產生任何費用。

如果操作失敗，通常是以下原因之一：

• 錯誤 -1052，權限不足。金鑰缺少合約權限，或不支援該交易對。
• 新建金鑰出現權限錯誤。等待 15 分鐘讓設定生效。
• HTTP 429。平台傳送的請求過多。WEEX 的 REST 限制為每個 IP 每 10 秒 500 權重。
• 簽名或通行口令錯誤。三項資料中有一項在貼上時漏掉字元，或多了空格。
• 啟用 IP 綁定後請求遭拒。平台使用的連線 IP 位址不在你的清單中。

WEEX 的合約 API 常見問題列出了完整錯誤代碼。

WEEX API 金鑰安全：限制損失的六項設定

交易金鑰無法提領資金，但仍可能造成虧損。在任何交易所，已知的濫用手法之一，是攻擊者利用遭竊的僅限交易金鑰，從自己控制的帳戶以高價買入流動性不足的代幣。以下六個習慣有助於降低風險。

1. 只授予最低限度的權限。報稅和投資組合工具只需要唯讀權限。KoinX 要求的正是這項權限。唯讀金鑰無法下單。
2. 平台支援時一律綁定 IP。WEEX 文件指出，未綁定 IP 的金鑰「存在安全風險」。部分服務無法使用固定 IP 清單。KoinX 建議使用者關閉 IP 限制。如果平台需要不受限制的金鑰，請將該金鑰設為唯讀。
3. 每個平台使用一組金鑰。最多可建立 10 組金鑰，因此沒有理由共用金鑰。使用獨立金鑰，就能在不影響其他服務的情況下停用其中一項服務，也能查出是哪項服務的金鑰外洩。
4. 將通行口令視為第三項機密。不要將它放在螢幕截圖、聊天訊息或客服支援單中。WEEX 的指引十分明確：「切勿分享你的通行口令。」
5. 拒絕超出交易所需範圍的權限要求。整合指南列出的自建金鑰權限為唯讀、現貨和合約。若平台要求你的 WEEX 登入密碼或提領權限，代表它索取了交易不需要的資料或權限。
6. 有疑慮就刪除。WEEX 建議立即刪除遭入侵的金鑰。對於已停止使用的平台，也應採取相同做法。

如何中斷平台與 WEEX 的連接

先在平台內移除金鑰，再到 WEEX 的「API 管理」中刪除金鑰。第二個步驟才是關鍵，因為只在平台設定中移除的金鑰，任何持有副本的人仍然可以使用。

透過快速連接建立的金鑰也適用相同規則。WEEX 的 OAuth 指南指出，必須先刪除現有金鑰，才能再次將帳戶連結至該平台。

將平台連接至 WEEX 只需幾分鐘，而這幾分鐘內做出的選擇，會決定金鑰存在期間的風險：授予哪些權限、允許哪些 IP，以及是否會在不再需要時清理金鑰。你可以在 WEEX API 頁面建立及管理金鑰。

常見問題

1. 我可以在 WEEX 建立多少組 API 金鑰？

根據 WEEX 的整合準備指南，每個帳戶最多可建立 10 組 API 金鑰。數量足以讓每個已連接的平台各自使用一組金鑰，因此可以撤銷某項服務的金鑰，而不影響其他服務。

2. 遺失的 WEEX API 通行口令可以重設嗎？

不可以。WEEX 文件指出，遺失的通行口令無法找回或修改。請刪除該金鑰，以新的通行口令建立新金鑰，並更新原先使用該金鑰的平台。

3. 為什麼我的新 WEEX API 金鑰會回傳權限錯誤？

通常有三個原因：缺少交易權限、金鑰的市場權限不涵蓋該交易對，以及尚未生效。WEEX 表示，新建或修改的金鑰約需 15 分鐘才會生效，因此先等待後再試一次，然後再調整設定。

4. WEEX 支援 TradingView 或 FIX 連線嗎？

WEEX 的合約 API 常見問題指出，目前不支援 TradingView 整合和 FIX API。連線是透過 REST 和 WebSocket 介面直接進行，或經由已整合這些介面的平台進行。