如何建立 WEEX API 金鑰:唯讀或交易權限
如何建立 WEEX API 金鑰:唯讀或交易權限
在網頁版 WEEX 登入,前往「帳戶 → API 管理」建立 API 金鑰。新金鑰預設為 唯讀。若應用程式需要進行交易,請選擇相應的 現貨 或 期貨/合約 權限。
建立金鑰前,請先決定要由哪個應用程式使用。監控餘額的指令碼和自動交易策略需要不同的存取權限。根據特定用途選擇權限,有助於管理及排除整合問題。
應該選擇哪種權限?
| 您想執行的操作 | 從哪裡開始 |
|---|---|
| 讀取公開行情、訂單簿或交易所設定 | 公開端點不需要帳戶驗證,因此您可以不使用金鑰直接開始。 |
| 查詢餘額或私人訂單資訊 | 建立唯讀金鑰,並確認目標端點的權限要求。 |
| 透過應用程式執行現貨交易 | 設定現貨權限。 |
| 透過應用程式執行合約交易 | 設定期貨/合約權限。 |
唯讀金鑰無法下單或取消訂單。請分別確認現貨和合約交易權限;啟用其中一項並不代表另一項也可使用。現貨準備指南和期貨準備指南說明了相關存取權限。
建立 API 金鑰
1. 開啟 API 管理。登入後,前往API 管理,或在WEEX API 頁面選擇「建立 API」。
2. 輸入詳細資料並選擇權限。依照目前顯示的欄位填寫。若要查詢帳戶資訊,請保留唯讀存取權限;若需要交易,則選擇相應的市場。
3. 設定通行密語和 IP 綁定。API 通行密語是您為此金鑰設定的存取密語。官方常見問題建議使用英文字母和數字,不要使用特殊字元。請依照頁面要求設定 IP 綁定。
4. 完成安全驗證並儲存憑證。妥善保存 APIKey、SecretKey 和 Passphrase,然後使用允許的唯讀請求驗證整合是否正常。
欄位順序可能會有所變動,請依照帳戶中顯示的提示操作。如果您要連接第三方工具,請在輸入憑證前確認該工具要求的權限與您打算使用的功能相符。
APIKey、SecretKey 和 Passphrase 如何使用?
APIKey 用來識別 API 請求,SecretKey 用來產生請求簽章,而 Passphrase 是您建立金鑰時設定的存取密語。三者的用途各不相同。API 通行密語也不同於您的帳戶登入密碼。
如果工具要求輸入「API Password」,請查看其欄位定義。例如,CCXT 的 password 欄位應填入 WEEX API 通行密語。即使 APIKey 和 SecretKey 正確,輸入錯誤仍可能導致私人請求無法通過驗證。
官方文件指出,遺失的通行密語無法復原,您必須建立新的 API 金鑰。建立憑證時,請將其存放在受控的伺服器環境或密鑰管理工具中,不要依賴聊天訊息、螢幕截圖或程式碼中的純文字常數。
綁定應用程式實際使用的 IP
如果應用程式部署在伺服器上,請綁定其用來傳送請求的對外公開 IP。代理伺服器、NAT 或雲端服務可能會變更外部位址,因此伺服器的私人 IP 可能與 WEEX 實際看到的來源位址不同。
遷移伺服器或變更對外網路時,請重新確認 IP 綁定。一般帳戶應依照 API 管理頁面的指示操作。經紀商終端使用者 API 適用不同規則,其 IP 輸入限制或強制條件不應套用至所有帳戶。
兩份準備指南都指出,每位使用者最多可建立 10 組 API 金鑰。依應用程式用途分開設定,例如一組用於帳戶監控,另一組用於交易,日後更換或停用特定整合會更容易。
為什麼建立金鑰後仍可能無法使用?
請從故障發生的位置開始排查,不要一再建立替代金鑰:
| 症狀 | 優先檢查項目 |
|---|---|
| 帳戶查詢正常,但訂單失敗 | 目標市場的交易權限。權限不符是造成 -1052 的可能原因之一。 |
| 私人請求驗證失敗 | API 通行密語、簽章、時間戳記和實際對外 IP。 |
| 新建立或修改的金鑰暫時無法使用 | 目前的常見問題說明,通常需要約 15 分鐘傳播生效,但這並非保證的期限。 |
| API 受限狀態持續存在 | 請聯絡官方客服了解帳戶限制,不要反覆傳送無效請求。 |
如需進一步協助,請透過官方 API 常見問題中的支援連結聯絡客服,並提供時間、端點和錯誤代碼。請在記錄中隱藏憑證、簽章和敏感帳戶資料。
如果您懷疑金鑰已外洩,請停止受影響的整合、刪除外洩的金鑰、檢查帳戶和訂單記錄,並以所需權限建立替代金鑰。