常見 Hyperliquid 錯誤訊息詳解
使用 Hyperliquid 交易時，有時會彈出錯誤提示。這些訊息通常很短，未必有詳細解釋，第一次遇到時容易令人不知所措。本文整理常見的 Hyperliquid 錯誤類型，解釋背後意思，並提供對應處理方法，方便你快速排查問題。
錯誤類型總覽
Hyperliquid 的錯誤大致可分為四類：
- 帳戶狀態類：保證金不足、帳戶未初始化等
- 訂單參數類：價格超出範圍、數量無效等
- 合約／交易對類：市場暫停、倉位超限等
- 連線與簽名類：錢包簽名失敗、連線逾時等
帳戶狀態類錯誤
"Insufficient margin" / 保證金不足
意思： 提交訂單時，帳戶可用保證金不足以覆蓋該倉位所需的初始保證金。
處理方法：
- 減少訂單規模，降低所需保證金
- 降低槓桿倍數
- 向帳戶存入更多 USDC
- 平掉部分現有倉位，以釋放保證金
保證金計算邏輯可參閱 Hyperliquid 官方文件。理解交叉保證金與逐倉保證金的分別，有助你在下單前預判是否可能觸發此錯誤。
"Account not found" / 找不到帳戶
意思： 該錢包地址在 Hyperliquid 上未有初始化記錄，通常出現在首次使用時。
處理方法： 完成首次充值並簽署所需的初始化交易後，帳戶便會啟用。同時請確認你使用的是正確錢包地址。
"Leverage too high" / 槓桿超出上限
意思： 設定的槓桿倍數超過該交易對允許的最高槓桿。
處理方法： 下單前先檢查該交易對的最高槓桿限制，並調整至允許範圍內。
訂單參數類錯誤
"Price out of range" / 價格超出範圍
意思： 提交的限價單價格與目前標記價格偏離太大，超出協議允許的價格區間。
處理方法： 調整限價單價格，令其更接近現時市場價。Hyperliquid 對掛單價格設有偏離限制，主要是為了避免極端錯誤掛單影響市場。
"Size too small" / 數量過小
意思： 提交的訂單數量低於該交易對的最小交易單位。
處理方法： 增加下單數量，或改用最小交易單位更小的交易對。
"Invalid order type" / 無效訂單類型
意思： 提交的訂單參數組合無效，例如在不支援的情況下使用了某種特定訂單類型。
處理方法： 重新檢查訂單參數，確認所選訂單類型與目前市場狀態相容。
合約與交易對類錯誤
"Market is paused" / 市場暫停
意思： 該交易對目前處於暫停狀態，可能由協議維護、價格異常熔斷或其他原因觸發。
處理方法： 等待市場恢復正常，並留意 Hyperliquid 官方公告了解最新狀態。市場暫停期間，現有倉位通常仍會維持原狀。
"Position size limit exceeded" / 倉位超出上限
意思： 目前帳戶在該交易對的持倉名義價值已達到協議設定上限。
處理方法： 減少新增訂單規模，或先平掉部分倉位後再操作。倉位上限的設計，是為了減低單一帳戶操控市場的風險。
"Max open orders exceeded" / 掛單數量超出上限
意思： 帳戶在單一交易對或全局的未成交掛單數量已達上限。
處理方法： 取消部分不需要的掛單，釋放額度後再提交新訂單。
連線與簽名類錯誤
"Signature invalid" / 簽名無效
意思： 錢包簽名驗證失敗，可能原因包括簽名時間過期、錢包切換了帳戶，或網絡異常導致簽名資料不完整。
處理方法：
- 重新整理頁面，再次發起簽名請求
- 中斷錢包連線後重新連接
- 檢查錢包目前選中的帳戶，是否與 Hyperliquid 綁定地址一致
使用 OneKey 錢包時，每筆簽名請求都會在裝置上清楚顯示交易內容，方便你核對簽名是否被意外篡改。EIP-712 結構化簽名標準可讓用戶在簽名時看到較易理解的格式，而不是只有純哈希值。
"Wallet not connected" / 錢包未連接
意思： 前端偵測不到已連接的錢包。
處理方法： 在頁面重新連接錢包。如果你使用 WalletConnect 連接手機錢包，請檢查 WalletConnect session 是否仍然有效，並參考 WalletConnect 文件了解重連步驟。
"Transaction rejected" / 交易被拒絕
意思： 用戶在錢包端手動拒絕簽名請求，或簽名逾時後被系統取消。
處理方法： 重新提交操作，並在錢包彈出簽名請求時及時確認。
資金相關錯誤
"Withdrawal amount exceeds available balance" / 提款金額超出可用餘額
意思： 申請提款的金額超過帳戶可用餘額，或者有未結算倉位佔用了部分資金。
處理方法： 檢查帳戶的未實現盈虧及保證金佔用情況，確認可提餘額後再重新操作。出入金機制可參考 Hyperliquid App 的餘額面板。
快速排查清單
減少頻繁報錯的建議
- 在 Hyperliquid 下單前，先檢查保證金餘額及槓桿設定
- 使用穩定的瀏覽器及網絡環境，避免簽名逾時
- 透過 OneKey Perps 接入 Hyperliquid，配合 OneKey 錢包較清晰穩定的簽名流程，減少因錢包端問題導致的簽名錯誤
- 保存 Hyperliquid 官方 Discord 入口，遇到未知錯誤時可第一時間查詢官方回覆
常見問題
Q1：報錯後我的資金會不會消失？
一般不會。大部分錯誤只代表操作未有成功執行，資金仍然留在帳戶內。不過，如果是倉位被強平（Liquidation），保證金有機會被全部或部分扣除；這屬於正常風控機制，並不是一般報錯。
Q2：同一個錯誤不停出現，應該怎樣做？
建議記錄錯誤訊息、操作步驟及相關截圖，到 Hyperliquid 官方社群描述問題，或透過 Hyperliquid App 的幫助入口聯絡支援。
Q3：出金時出現錯誤，資金會被鎖定嗎？
通常不會。出金失敗一般代表操作未提交或未完成，資金仍在帳戶內。你可以稍等片刻後重試，或聯絡官方支援查詢。
Q4：如何分辨是我的操作問題，還是協議 bug？
可以透過鏈上資料確認該操作是否有記錄。如果鏈上完全沒有該筆操作記錄，通常較可能是客戶端或連線問題；如果鏈上有記錄但結果異常，則可能需要向官方回報。
Q5：MetaMask 和 OneKey 錢包，哪個在 Hyperliquid 上更穩定？
兩者均受支援。OneKey 完全開源，用戶可在 OneKey GitHub 查看代碼；其簽名介面亦較透明，對重視安全審計及簽名可讀性的用戶而言，能提供額外信心。
結論
遇到 Hyperliquid 錯誤訊息時，毋須即時慌張。絕大部分錯誤都有明確原因及處理方法，按本文分類逐步排查，通常可以在短時間內恢復正常操作。
如果你希望在較清晰、安全的環境下交易 Hyperliquid 永續合約，可以下載並試用 OneKey，透過 OneKey Perps 接入 Hyperliquid，配合硬件錢包及透明簽名流程管理交易操作。
風險提示： 本文內容僅供參考，不構成任何投資、法律或財務建議。加密貨幣及永續合約交易風險極高，包括但不限於市場劇烈波動、槓桿放大虧損、技術故障及監管風險。請在充分了解風險後，再自行作出決定。
