籌碼函數取值邏輯與使用指南

摘要：台灣期貨交易所每日約 14:00 後公布「前一交易日」三大法人日盤數據；
每日約 07:00~07:15 後公布「當日夜盤」三大法人數據。

重點：getchip() 依照你在程式中提供的日期與時間，回傳「當時可取得的最新官方公布資料」。
跨週、休市或未開盤時，延用上一個有效交易日（或上一個夜盤）的數據。

1) 日盤取值邏輯

1. 交易所約於 14:00 後公布「前一交易日」三大法人進出。

2. 你在程式帶入的 日期+時間 將對應到「當下已公布」的最新日盤資料。

範例

現在 2025/08/02 11:00，查詢時間也為 2025/08/02 11:00。回傳資料就是 2025/08/01 14:00 後公布之數據。

若改在 2025/08/02 15:00 查詢，回傳資料 = 2025/08/02 於 14:00 後公布之數據。

注意：跨週、前一日休假或未開盤時，系統將延用上一個交易日的數據。

2) 夜盤取值邏輯

1. 交易所每日早上約 07:00~07:15 公布當日夜盤三大法人。

2. 你在程式帶入的 日期+時間 將回傳「該日已公布」之夜盤資料。

範例

查詢區間 2025/05/30 08:45 ~ 2025/05/31 05:00 的夜盤籌碼，回傳結果對應交易所網站

2025/05/30 07:00 後公布之數據。

注意：跨週、前一交易日未開盤時，延用上個夜盤的公布數據。

3) 實作範例

3.1 日盤測試程式

    inputs:
        FIELD_DATE(D),
        FIELD_TIME(time_s);

    vars:
        SYMBOL_NAME("SPF");

    value1 = getchip(SYMBOL_NAME, FIELD_DATE, FIELD_TIME, 3, 1, 2, 1);

    plot1(value1, "OB");

3.2 夜盤測試程式（期權範例）

    inputs:
        SYMBOL_NAME("TXO.C"),
        FIELD_DATE(D),
        FIELD_TIME(time_s);

    value1 = Getchip(SYMBOL_NAME, FIELD_DATE, FIELD_TIME, 17, 1, 1, 1);
    plot1(value1);

5) 常見疑問

1. Q. 為何回傳日期比我查詢的日期早一天?

A. 因為日盤資料於約 14:00 後才會公布；在此之前查詢會回傳上一個交易日。

2. Q.夜盤可否查未平倉?

A. 不支援

本文僅說明取值邏輯，實際更新時點仍以台灣期貨交易所公布為準。