錯誤碼
本頁提供 Webull OpenAPI 回傳的錯誤碼完整參考。
錯誤回應格式
所有錯誤回應遵循統一的 JSON 結構：
{
"error_code": "ERROR_CODE",
"message": "可讀的錯誤描述訊息。"
}
錯誤碼參考
| HTTP 狀態碼 | error_code | Message | 說明 |
|---|---|---|---|
| 401 | MISSING_APP_KEY | Header x-app-key is missing. | 請求中缺少必要的 x-app-key 標頭。 |
| 401 | MISSING_SIGNATURE | Header x-signature is missing. | 請求中缺少必要的 x-signature 標頭。 |
| 401 | MISSING_ALGORITHM | Header x-signature-algorithm is missing. | 請求中缺少必要的 x-signature-algorithm 標頭。 |
| 401 | MISSING_NONCE | Header x-signature-nonce is missing. | 請求中缺少必要的 x-signature-nonce 標頭。 |
| 401 | MISSING_TIMESTAMP | Header x-timestamp is missing. | 請求中缺少必要的 x-timestamp 標頭。 |
| 401 | INVALID_TOKEN | Header x-access-token is missing or invalid. | x-access-token 標頭缺失或包含無效值。 |
| 401 | UNAUTHORIZED | Invalid credentials. Please verify your credentials and ensure you are connecting to the correct environment. | app_key/app_secret 無效、已過期、已撤銷、已停用，或正在對錯誤的環境發起請求。 |
| 401 | UNAUTHORIZED | Header x-signature is invalid. | 請求簽名與預期值不匹配，請檢查簽名邏輯。 |
| 401 | UNAUTHORIZED | Access denied. The request IP does not match your configured settings. | 請求來源 IP 不在已設定的 IP 白名單中。 |
| 401 | UNAUTHORIZED | Access denied. Please contact support for more details. | 驗證 IP 白名單設定時發生內部錯誤，請聯繫客服。 |
| 401 | UNAUTHORIZED | Your app key has been disabled. Please contact support for more details. | 您的 app key 已被管理員停用。 |
| 401 | UNAUTHORIZED | Your authorization has been revoked. Please contact your administrator. | 開發者授權已被撤銷。 |
| 401 | UNAUTHORIZED | Your app key is not in a valid status. Please contact support for more details. | 您的 app key 處於無效狀態（未啟用、已暫停等）。 |
| 401 | ILLEGAL_TIMESTAMP | Header x-timestamp is invalid. | x-timestamp 值不符合 ISO 8601 格式，或超出可接受的時間窗口。 |
| 401 | VERSION_NOT_SUPPORTED | Header x-signature-version is invalid. | x-signature-version 不受支援，目前僅支援 1.0。 |
| 401 | SIGNATURE_ALGORITHM_NOT_SUPPORTED | Header x-signature-algorithm is invalid. | 簽名演算法不受支援，請使用 HMAC-SHA1。 |
| 401 | ROUTE_NOT_PERMITTED | You do not have permission to access this endpoint. Please contact support to request access. | 您的應用程式沒有呼叫此 API 端點的權限。 |
| 401 | UNAUTHORIZED_STREAM_DATA | Insufficient permission. Please subscribe to the required market data and try again. | 您的應用程式尚未訂閱所需的行情數據。OpenAPI 行情訂閱與 Webull App 訂閱相互獨立。 |
| 403 | ACCOUNT_ACCESS_DENIED | Invalid account or insufficient permissions. | account_id 不屬於已驗證的憑證，或 URL 參數與標頭中的 account_id 不一致。 |
| 403 | ROUTE_NOT_PERMITTED | You do not have permission to access this endpoint. Please contact support to request access. | 您的應用程式沒有呼叫此 API 端點的權限。 |
| 403 | MARKET_DATA_NOT_SUBSCRIBED | Insufficient permission. Please subscribe to the required market data and try again. | 需要行情數據訂閱。 |
| 403 | APP_NOT_ACTIVATED | Your app is not activated. Please contact support for more details. | 您的應用程式尚未啟用，請聯繫客服。 |
| 500 | SYSTEM_ERROR | An unexpected error occurred. Please try again later or contact support for more details. | 發生內部伺服器錯誤，請使用指數退避重試或聯繫客服。 |
| 500 | INTERNAL_SERVER_ERROR | An unexpected error occurred. Please try again later or contact support for more details. | 暫時性內部錯誤，請重試；若問題持續，請聯繫客服。 |