SDK 錯誤代碼表

Tapio SDK 的每次 API 請求都會帶回一個狀態碼。數值 0（成功）代表請求正常完成，其餘代碼表示錯誤或特殊狀態。本表依數值升冪排列，供整合開發時對照查詢。

關於 session

多個狀態碼提到的 session，指系統為每個獲准在系統上交易的投資人所維護的當日交易狀態，涵蓋該帳號當日的持倉、委託、委託回報與帳戶餘額。每個獲准交易的投資人都有一個專屬的 session；同一時間，系統只允許一條連線透過「登入」持有該 session。session 於每個交易日重置。

未列出的代碼

各數值區間中未出現於本表者為保留代碼，目前未使用。0（成功）與 248（預熱請求完成）為非錯誤狀態，仍列入本表並於說明標註。

數值	英文代碼	中文名稱	說明
0	GW_SUCCESS	成功	請求成功完成，非錯誤狀態。
1	GW_CONNECTION_RATE_LIMIT	連線速率限制	此連線的請求頻率超出允許上限，請降低送單速率。
2	GW_RECV_CORRUPTED_PACKET	封包損毀	收到的封包資料不完整或毀損。
3	GW_RECV_BAD_HEADER_PACKET	封包標頭錯誤	收到的封包標頭格式不正確。
4	GW_UNSUPPORTED_SYMBOL_TEXT	不支援的商品代碼	指定的商品代碼無法識別或不支援。
5	GW_MISSING_PRODUCT_INFO	查無商品資訊	找不到該商品的基本資料。
6	GW_MISSING_CONTRACT_INFO	查無契約資訊	找不到該商品的契約資料。
7	GW_MISSING_FLOW_GROUP	商品未開盤	該商品目前無可用的交易時段（市場已收盤或尚未開盤）。
8	GW_CONTRACT_STATUS_NOT_NORMAL	契約狀態非正常	此契約目前狀態非正常，暫停交易。
9	GW_UNSUPPORTED_SYMBOL_OPTION	不支援選擇權	系統不支援選擇權商品交易。
10	GW_UNSUPPORTED_SYMBOL_MARGIN_PERCENT	不支援比例保證金商品	系統不支援保證金型態為「比例」的期貨商品。
11	GW_REQUIRED_MARGIN_EXCEED	保證金不足	所需保證金超出帳戶可動用餘額。
12	GW_CONNECTION_IS_NOT_LOGON	連線尚未登入	此連線尚未完成登入。
13	GW_SESSION_NOT_FOUND	查無 session	找不到目前連線對應的 session。
14	GW_MISSING_POSITION_IN_SESSION	session 內查無商品部位	此 session 中找不到該商品的部位資料。
15	GW_ILLEGAL_REQUEST_ID	請求識別碼無效	請求的識別碼欄位不正確。
16	GW_WRONG_PASSWORD	密碼錯誤	登入密碼不正確。
17	GW_PASSWORD_LOCKED	帳號已鎖定	密碼錯誤次數過多，帳號已被鎖定。
18	GW_ID_NOT_FOUND	查無此 ID	找不到指定的 ID。
19	GW_INVESTOR_ACCOUNT_NOT_FOUND	查無投資人帳號	找不到指定的期貨帳號。
20	GW_INVALID_SIDE	買賣別無效	委託的買賣別欄位不正確。
21	GW_INVALID_ORDER_TYPE	委託類型無效	委託類型欄位不正確。
22	GW_INVALID_TIME_IN_FORCE_TYPE	委託效期無效	委託效期類型欄位不正確。
23	GW_INVALID_POSITION_EFFECT_TYPE	開平倉碼無效	開平倉類型欄位不正確。
24	GW_USER_DISALLOW_TRADING	禁止交易	此帳號目前被禁止交易。
25	GW_USER_DISALLOW_MARKET_ORDER	禁止市價單	此帳號不允許下市價單。
26	GW_INVALID_ORDER_NO	委託書號無效	委託書號欄位不正確。
27	GW_NEGATIVE_BALANCE	帳戶餘額為負	帳戶餘額為負數。
28	GW_DENY_OPEN_POSITION	禁止開倉	此帳號不允許建立新倉。
29	GW_QTY_EXCEED_LIMIT	委託口數超限	委託口數超出單筆上限。
30	GW_MISSING_ORDER_IN_SESSION	session 內查無委託	此 session 中找不到該筆委託。
31	GW_MISSING_ORDER	查無委託	找不到指定的委託。
32	GW_BAD_POSITION_EFFECT	開平倉碼不適用	目前持倉狀況無法使用此開平倉碼。
33	GW_UNSUPPORTED_SYMBOL_TWOLEG	不支援複式商品	系統不支援兩隻腳（複式）商品。
34	GW_KEY_EXPIRED	API 金鑰已過期	使用的 API 金鑰已逾有效期。
35	GW_IP_MISMATCH	來源 IP 不符	連線來源 IP 與綁定 IP 不一致。
36	GW_INVALID_ACNO	帳號超出範圍	投資人帳號編號超出允許範圍。
37	GW_TRADING_TIME_IS_OVER	非交易時段	目前非該商品的交易時段。
38	GW_DISALLOWED_TIME_IN_FORCE	委託效期不允許	此連線不允許使用該委託效期類型。
39	GW_POSITION_LIMIT	逾部位限制	已達部位上限。
40	GW_CONNID_EXHAUSTED	連線識別碼用盡	連線識別碼資源池已耗盡。
42	GW_DAILY_LOGIN_LIMIT	逾每日登入上限	此帳號已達當日登入次數上限。
43	GW_PRICE_LIMIT_UNAVAILABLE	漲跌幅資料不可用	漲跌幅資料暫時無法取得，請稍後重試。
44	GW_MISSING_QUOTE_DATA	查無報價資料	此商品缺少報價資料。
45	GW_UNSUPPORTED_CURRENCY	不支援的幣別	指定的幣別不支援。
46	GW_MISSING_TAX_RATE	查無稅率資料	此契約缺少稅率資料。
47	GW_SYMBOL_INIT_FAILED	商品初始化失敗	在此 session 中初始化該商品失敗。
48	GW_UNKNOWN_MESSAGE_TYPE	未知訊息類型	收到無法識別的訊息類型。
49	GW_INVALID_INVESTOR_FLAG	投資人身份碼無效	連線上的投資人身份碼為未知值。
50	GW_INVALID_EXPIRY	到期日無效	到期日無效或超出允許範圍。
51	GW_KEY_WRITE_FAILED	金鑰寫入失敗	新 API 金鑰寫入失敗。
52	GW_DUPLICATE_KEY	金鑰重複	產生的 API 金鑰與既有金鑰衝突。
53	GW_INVESTOR_EMAIL_EMPTY	未登記 email	此投資人未登記 email 位址。
54	GW_NO_ACTIVE_API_KEY	無有效金鑰	此投資人沒有有效（未過期）的 API 金鑰。
55	GW_MAIL_SPOOL_IO_ERROR	郵件寫入失敗	系統寄送通知信時寫入失敗。
56	GW_MISSING_POSITION_LIMIT	未設定部位上限	此類商品未設定部位上限。
58	GW_MISSING_MARGIN_DATA	未設定保證金資料	此類商品未設定保證金資料。
127	GW_UNEXPECTED_CLIENT_SIDE_ERROR	用戶端未預期錯誤	用戶端發生未預期的錯誤。
128	GW_CONNTION_NOT_READY	連線尚未就緒	系統尚未與交易所主機建立連線。
129	GW_CORRUPTED_CONNECTION	連線損毀	連線狀態異常，請重新連線。
130	GW_CONNECTION_ALREADY_LOGON	連線已登入	此連線先前已完成登入。
131	GW_ACCOUNT_HAS_BEEN_LOGON	帳號已在他處登入	此帳號已於其他地方登入。
132	GW_MISSING_SESSION	查無帳號 session	系統中查無此帳號的 session（帳號未納入今日交易）。
133	GW_MISSING_SYSTEM_TYPE	缺少系統別	請求缺少系統別資訊。
134	GW_EMPTY_CONNECTION_POOL	連線池為空	對應的連線資源池為空。
135	GW_ORDER_NO_IS_EXHUASTED	委託書號用盡	委託書號已用盡，無法繼續送單。
136	GW_UNSUPPORTED_PROTOCOL_VERSION	不支援的協定版本	伺服器不支援用戶端使用的協定版本。
246	GW_INVALID_SYSTEM_TYPE	無法判定系統別	無法判定此商品的系統別。
248	GW_PLACE_ORDER_PRE_WARMED	預熱請求完成	預熱請求已完成，非錯誤狀態。
249	GW_TMP_CONNECTION_RATE_LIMIT	逾交易所速率上限	送單頻率已達交易所端的速率上限。
250	GW_GATEWAY_SHUTTING_DOWN	系統關閉中	系統正在關閉，請求遭拒。
251	GW_SESSION_CORRUPTED	session 已損毀	session 狀態損毀，請重新連線。
252	GW_UNIMPLEMENTED	功能未實作	此功能尚未實作。
253	GW_SYSTEM_PAUSE_TRADING	系統暫停交易	系統目前已暫停所有交易。
254	GW_UNEXPECTED_SERVER_SIDE_ERROR	伺服端未預期錯誤	伺服端發生未預期的錯誤。