跳到主要內容

IBKR Web API 夜盤改制前怎麼查?OVT/OND 與 EARLY 設定盤點(2026)

最後更新: ·
IBKR Web API 夜盤設定盤點:IBKR 官方標誌與 OVT、OND、ERL/EPD 待核對清單

保存的 IBKR Web API 夜盤設定裡,還有 OVT、OND 或 OVERNIGHT 嗎?現在先做一張待改清冊:找出舊值、記下掛單狀態,再逐商品查新時段能力。不要看到新代碼就整批替換,因為新的 EARLY 與過去整段 Overnight,涵蓋的時間不同。

IBKR 在 2026 年 11 月 19 日更新日誌新增 EARLY 文件,並為舊夜盤提交方式加上棄用標記。以下依 11 月 22 日讀到的 Web API 文件整理;完成結果是一份不含帳密、可以交給程式維護者處理的清單。本篇未登入帳戶,也未測試未來 EARLY 送單或成交。查詢沿用你已授權的環境;若沒有查詢環境,就先完成離線設定盤點,掛單與商品規則欄標記待查。

符合資格新戶;最高 US$1,000;等值 IBKR 股票(非現金);查看資格與流程

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 成交紀錄,不要把「清單沒有」直接解讀成未成交。確認已成交量與剩餘意圖以前,不自動重建舊單。清冊完成的標準是每筆都有下一個處理人與缺口,而不是把每格都塗成通過。

符合資格新戶;最高 US$1,000;等值 IBKR 股票(非現金);查看資格與流程

接著閱讀

左右滑動查看更多推薦

ALPHALAB 社群

有問題?來 Telegram 聊

和 Terry、編輯、其他網友一起討論這篇文章。提問、分享觀點,回覆更即時。

加入 Telegram 討論

📩 訂閱 AlphaLab 電子報

週日 Weekly 週報+週二、週四 Alpha Signal,每週最多三封。

我們不會 spam,隨時可退訂。已訂閱?管理訂閱偏好(會寄登入連結到你的信箱)

主題篩選與退訂說明

寄送日期以台灣時間為準。主題偏好會篩選每期精選,並非每篇新文章的即時通知;當期符合主題的文章不足時會略過寄送。

未勾選任何主題會收到所有主題的精選,並不會停止寄信。

取消勾選 Alpha Signal 可停止週二、週四短報,仍保留週日週報。若要停止所有電子報,請使用信件底部的「取消訂閱」。