Skip to main content

錯誤碼與狀態碼對照表

本頁面彙整了富邦新一代 API(期貨交易)中常見的狀態碼、功能代碼與事件代碼,方便開發者在遇到問題或進行狀態判斷時快速檢索。

委託單狀態 (Status)

委託單的當前狀態,可透過 GetOrderResult 查詢或由主動回報取得。各語言 SDK 的實際查詢方法名稱分別為 Python get_order_results、Node.js getOrderResults 及 C# GetOrderResult

狀態名稱狀態碼 (Value)說明
預約單0預約單
中台收到委託4中間狀態;請用 GetOrderResult 查詢最新狀態
交易所回報處理中8交易所回報的中間狀態,常見於非漲跌停價委託;get_resultget_result_detail 不會顯示此狀態
後台連線逾時9請稍後再使用 GetOrderResult 查詢狀態,或聯絡您的營業員
委託或變更成功10新單成功;改價或改量成功也會直接回傳 10,須檢視回傳的委託欄位以判斷變更項目
刪單成功30刪單成功
部分成交,剩餘取消40部分成交後,剩餘未成交口數已取消
完全成交50完全成交
改價失敗19改價失敗
改量失敗29改量失敗
刪單失敗39刪單失敗
失敗90失敗
期貨與證券狀態碼的差異
  • 期貨沒有證券使用的改價、改量成功狀態碼 1520,也沒有 ACK 狀態碼 142434
  • 期貨改價或改量成功時,回報的 status 會直接是 10。請檢視該筆 10 回報中的價格與數量欄位,以區分改價或改量。
  • 8 是交易所回報的中間狀態,常見於非漲跌停價委託,而且不會出現在 get_resultget_result_detail 的查詢結果中。

功能類別 (Function Type)

表示該筆回報或查詢結果所屬的操作類型。此處的 1520 是功能類別,不是期貨委託的改價、改量成功狀態碼。

功能名稱代碼 (Value)說明
新單0新單
新單執行10新單執行
改價15改價
改量20改量
刪單30刪單
失敗90失敗

事件代碼 (Event Code)

透過 on_event 訂閱事件通知時,系統會回傳以下代碼。

回傳代碼意義
100連線建立成功
200登入成功
201登入警示 (例如:90天未更換密碼)
300斷線
301未收到連線 pong 回傳
302用戶執行登出,並斷線
304API Key 異動 (Revoked),已強制登出 (2.2.7版本新增)
500錯誤