保存的 IBKR Web API 夜盤設定裡,還有 OVT、OND 或 OVERNIGHT 嗎?現在先做一張待改清冊:找出舊值、記下掛單狀態,再逐商品查新時段能力。不要看到新代碼就整批替換,因為新的 EARLY 與過去整段 Overnight,涵蓋的時間不同。
IBKR 在 2026 年 11 月 19 日更新日誌新增 EARLY 文件,並為舊夜盤提交方式加上棄用標記。以下依 11 月 22 日讀到的 Web API 文件整理;完成結果是一份不含帳密、可以交給程式維護者處理的清單。本篇未登入帳戶,也未測試未來 EARLY 送單或成交。查詢沿用你已授權的環境;若沒有查詢環境,就先完成離線設定盤點,掛單與商品規則欄標記待查。

IBKR Web API 夜盤先核對兩個日期與三個舊值
11 月 19 日是文件更新日;2026 年 12 月 6 日 02:00 US/Eastern 才是 EARLY 文件警示寫明的舊 OVERNIGHT 停用時點。官方同時說,OVERNIGHT 目的地的既有掛單會被取消,OVT、OND 也隨之棄用。清冊應保留完整時區,別把文件公布日與停用日填成同一欄。
TIF 是 Time in Force,意思是委託有效期限/工作時段。舊 Web API 規格以 OVT 表示 Overnight、以 OND 表示 Overnight + Day;OVERNIGHT 則是交易目的地名稱。搜尋時三者都要找,不能只找你在畫面上記得的那個選項。
先確認程式使用的是 Web API。本篇只處理這套 HTTP/JSON 規格,不把 TWS API 的 Python 物件或 Client Portal 按鈕名稱混進來。若你平常手動操作,IBKR 夜盤下單與訂單生命週期可補介面背景;閱讀舊教學時仍要留意其適用日期,不把舊 TIF 直接抄回新設定。
先複製設定,再把掛單放到另一張清單
若還不熟悉帳戶與平台分工,可先讀 IBKR 基礎使用指南,再回來辨認自己實際使用的 API。
準備一個本機資料夾與可讀文字/JSON 的編輯器;要跑後面的範例,另需 Python 3。只複製你已整理過、不含秘密的設定片段:標的 conid(IBKR 辨識商品的合約編號)、買賣方向、orderType(委託類型)、tif、路由,以及是否帶 outsideRth。帳號改用自訂代稱;不要複製 token、Cookie、Authorization header、登入資訊或完整連線日誌。
在副本裡搜尋三個舊字串,逐筆記下檔名、設定名稱與使用位置。建立清冊時,也先預留規則取得時間、命中原文、委託類型核對、掛單核對時間、剩餘/已成交數量、預備修改、負責人與上線驗收等人工欄;後面的程式會直接帶出 conid、方向與 orderType。除了主要設定,也查看排程的預設值、重試分支、備援設定與測試樣本。命中是「需要人工判讀」,不是可以自動改字的授權;註解、歷史樣本與仍會執行的設定應分開標記。
再另建掛單清單,保留你自行核對的時間與時區、帳戶代稱、私下可追蹤的訂單識別、conid、方向、TIF、status、剩餘數量與已成交數量。這張清單記錄券商端的委託;前一張記錄本機程式。改了本機檔案,不代表既有委託已被改好或撤掉。
若你已經有合法使用中的查詢流程,可依 Live Orders 文件核對 GET /iserver/account/orders。回傳可能含已成交、已取消與仍工作中的單,要看 status、remainingQuantity、filledQuantity、timeInForce,不能把每列都當成未成交掛單。官方列有帳戶選取及 pre-flight 前置要求,單次最多 1,000 筆;沒有完整快照時,就在清冊寫「掛單待核對」。
委託狀態與成交紀錄仍應分開理解,授權停用後的掛單與成交核對可作為這項分工的延伸閱讀。
ERL 與 EPD 先選等待成交的時段,不能照舊名稱對號入座
依 IBKR 的新時段表與訂單範例,以下全部使用 US/Eastern;「隔日」只說明跨午夜的時段終點,不是在解釋 T+1 交割:
ERL:EARLY,委託在 20:00–21:00 等待成交。它只有這一小時,不能用來代表整段夜盤。EPD:EARLY + DAY,委託等待成交的時段為 20:00–隔日 20:00。先確認你是否要讓未成交委託留到隔天。- 官方同表另列 Outside RTH 為 21:00–隔日 20:00、RTH only 為 09:30–16:00;前者是表中的時窗名稱,不能把它與
outsideRth旗標視為同一件事。
例如,你原本保存 OVT,是因為只想讓委託在過去的隔夜時段等待成交。現在若直接換成 ERL,等待成交的時段就縮成 20:00–21:00;若換成 EPD,未成交委託又可能留到隔日。先把「我想讓委託在哪些時段等待成交」寫成文字,再填候選 TIF;若想要的時段不等於其中任何一個,就填「待釐清」,不要硬選。
清冊中的「官方候選值」與「已確認可用」要分欄。文件列出 EPD 的跨日時窗,不等於你已驗證每個商品、帳戶與委託類型都能使用,也不表示能連續成交。市場時段與交易日的背景,可接著讀 美股 23 小時交易指南;本篇的代碼核對仍以 Web API 規格為範圍。
IBKR Web API 夜盤商品能力:看自己的 tifTypes
對每個 conid 與買賣方向,查 Search Contract Rules的結果。端點是 POST /v1/api/iserver/contract/rules,用途是取得合約與方向的交易規則。實際新單提交另用 POST /iserver/account/{accountId}/orders,兩者要按端點用途區分。
查詢時,請求至少指定 conid;isBuy 預設為 true,賣出方向要用 false。把回應時間、方向、error 與 tifTypes(該商品允許的 TIF 清單)原始內容留在自己的資料夾,別拿文件裡的範例回應冒充你的商品結果。
官方要求在 tifTypes 找到 ERL 或 EPD 對應項,並核對相容的委託類型。因此,只在整份 JSON 找到「ERL」三個字仍不夠:要保存命中的完整字串,再確認你的 LMT(限價單)等委託類型對應到哪一項。本文程式只辨認斜線前的候選 TIF,不解讀斜線後所有縮寫,也不替你核准委託類型。
回應缺欄位、出現 error,或尚未列出候選值時,記成「待重查」,並保留時間與原始回應。這只能說該次結果未提供所需能力,不能延伸成永久不支援。即使已找到候選項,也應保留上線後再次查核的欄位。
另有一項容易漏掉的限制:EARLY 文件明確要求,送往 EARLY 的訂單不要包含 Order.outsideRth 旗標。Web API 改單欄位表則將 JSON 鍵寫成 outsideRTH。盤點時兩種拼法都查,連 false 也列為候選移除項;這不表示端點接受兩者互換,也不要以改大小寫代替移除。再看共用預設值是否會在最後合併時把它補回。官方 ERL/EPD 範例以 tif 表達路由意圖,別憑名稱添加未核對的路由欄位。
用離線 JSON 產出待改表,所有上線驗收先留白
把下面的假資料存成 inventory-input.json。這是自訂盤點格式,不是可提交的訂單:conid 的 null 代表尚未填入真實合約,rules 的 null 代表尚未取得結果,沒有價格與數量。exchange 在這裡是整理路由的欄位,不是要求你在新訂單新增此鍵;若原設定以 conidex 記錄 合約編號@目的地,也可保留該鍵供程式檢查。desired_window 可填 early_only、early_plus_day 或 undecided;它表達待確認的意圖,不會修改 saved_order。
[
{
"name": "demo-1",
"desired_window": "early_only",
"saved_order": {
"conid": null,
"side": "BUY",
"orderType": "LMT",
"tif": "OVT",
"exchange": "OVERNIGHT",
"outsideRth": false
},
"rules": null
}
]
將下方存成 audit_inventory.py。每個設定各複製一筆紀錄,填入去除秘密的舊值;取得有效規則後,再將對應回應物件放入 rules。若你取得的是物件陣列,先人工確認並挑出相符的規則物件,不能整包貼上混用。
"""Read a secret-free local inventory; print a CSV work list. No broker calls."""
import csv
import json
import sys
from pathlib import Path
records = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8"))
if not isinstance(records, list):
raise ValueError("Input must be an array")
fields = ["name", "conid", "side", "orderType", "old_tif",
"old_exchange", "old_conidex", "route_check", "candidate", "legacy",
"rules_check", "outsideRth_check", "release_check"]
writer = csv.DictWriter(sys.stdout, fieldnames=fields)
writer.writeheader()
for record in records:
order = record["saved_order"]
exchange = order.get("exchange", "")
conidex = order.get("conidex", "")
destinations = [str(v).rsplit("@", 1)[-1]
for v in (exchange, conidex) if v]
route_note = ("目的地衝突;待人工核對" if len(set(destinations)) > 1
else "未見兩欄目的地衝突;原設定仍待核對")
target = {"early_only": "ERL", "early_plus_day": "EPD"}.get(
record["desired_window"], "")
rules = record.get("rules")
entries = rules.get("tifTypes") if isinstance(rules, dict) else None
if not target:
rule_note = "待確認委託等待成交的時段;尚未比對候選值"
elif not isinstance(entries, list) or (rules or {}).get("error"):
rule_note = "待取得有效規則"
elif target and any(isinstance(x, str) and
x.split("/", 1)[0] == target for x in entries):
rule_note = "找到候選值;委託類型仍待人工核對"
else:
rule_note = "未找到候選值;待重查,不判定永久不支援"
row = dict(name=record["name"], conid=order.get("conid"),
side=order.get("side", ""), orderType=order.get("orderType", ""),
old_tif=order.get("tif", ""), old_exchange=exchange,
old_conidex=conidex, route_check=route_note,
candidate=target or "待決定",
legacy="需盤點" if order.get("tif") in {"OVT", "OND"} or
"OVERNIGHT" in destinations else "未命中舊值",
rules_check=rule_note,
outsideRth_check="候選 EARLY 訂單須移除此欄位" if
any(k.lower() == "outsiderth" for k in order) else
"此物件未含該欄位;合併設定另查",
release_check="待上線驗收;掛單另查")
# Keep spreadsheet programs from interpreting untrusted cells as formulas.
writer.writerow({k: "'" + str(v) if str(v).startswith(("=", "+", "-", "@"))
else v for k, v in row.items()})
先執行 python3 -m json.tool inventory-input.json 檢查 JSON 語法,再執行 python3 audit_inventory.py inventory-input.json > inventory.csv。第二個命令會建立或覆寫指定的 CSV,請使用新的輸出檔名。
用上面的原始假資料執行,demo-1 應顯示候選 ERL、舊值需盤點、規則待取得、outsideRth 待移除,以及上線與掛單待查。本機假資料驗證也核對了 exchange=SMART、conidex=123@OVERNIGHT、tif=DAY 仍會列為「需盤點」,並保留兩欄原值、標記目的地衝突;undecided 即使已有有效 tifTypes,也會先提示確認等待成交的時段。這些結果只證明清單產生器的行為,沒有證明 IBKR 接受任何訂單。若 JSON 語法錯誤,先修引號與逗號;若出現 KeyError,依範例補齊欄位後再跑。
將 CSV 與一開始建立的人工欄放在一起核對。CSV 已帶出 conid、side(方向)、orderType,並以 old_exchange、old_conidex 分別保留原路由值;任一目的地是 OVERNIGHT 就列為需盤點,兩者不同則在 route_check 標記衝突。舊路由還在、目的地衝突、候選時段不合、能力未明或掛單未核對的列,都維持待辦。此時可以提出程式修改草案,先不要接回自動送單排程。
到預定切換時點後,再取一次商品規則及掛單狀態;若舊委託不見了,同時核對取消狀態與 Trades 成交紀錄,不要把「清單沒有」直接解讀成未成交。確認已成交量與剩餘意圖以前,不自動重建舊單。清冊完成的標準是每筆都有下一個處理人與缺口,而不是把每格都塗成通過。

接著閱讀
左右滑動查看更多推薦






