Aggregates BETA

接收訂閱期權聚合數據的行情資訊

Parameters

Name	Type	Description
channel*	string	訂閱頻道：trades, candles, books, aggregates
symbol*	string	商品代碼
afterHours	boolean	true: 夜盤, false: 日盤, default: false

Response

Name	Type	Description
date*	string	日期
type*	string	期權類型
exchange*	string	交易所
market	string	市場別
symbol*	string	商品代碼
name*	string	商品名稱
previousClose	number	昨日收盤價
openPrice	number	開盤價
openTime	number	開盤價成交時間
highPrice	number	最高價
highTime	number	最高價成交時間
lowPrice	number	最低價
lowTime	number	最低價成交時間
closePrice	number	收盤價（最後成交價）
closeTime	number	收盤價（最後成交價）成交時間
avgPrice	number	當日成交均價
change	number	最後成交價漲跌（含試撮）
changePercent	number	最後成交價漲跌幅（含試撮）
amplitude	number	當日振幅
lastPrice	number	最後一筆成交價（含試撮）
lastSize	number	最後一筆成交數量（含試撮）
total	object	成交統計
total.tradeVolume	number	累計成交量
total.totalBidMatch	number	累計委買成交筆數
total.totalAskMatch	number	累計委賣成交筆數
total.time	number	統計時間
lastTrade	object	最後一筆成交資訊
lastTrade.bid	number	最後一筆成交買價
lastTrade.ask	number	最後一筆成交賣價
lastTrade.price	number	最後一筆成交價格
lastTrade.size	number	最後一筆成交數量
lastTrade.time	number	最後一筆成交時間
lastTrade.serial	string	最後一筆成交流水號
lastTrial	object	最後一筆試撮資訊
lastTrial.bid	number	最後一筆試撮買價
lastTrial.ask	number	最後一筆試撮賣價
lastTrial.price	number	最後一筆試撮價格
lastTrial.size	number	最後一筆試撮數量
lastTrial.time	number	最後一筆試撮時間
lastTrial.serial	string	最後一筆試撮流水號
isTrial	boolean	是否處於試撮狀態：試撮階段為 true，非試撮時省略此欄位（缺省視為 false）
serial	number	流水號
lastUpdated	number	最後異動時間

info

isTrial 反映「最近一筆行情訊息是否為試撮」——收到任何正式行情（成交或委託簿更新）即回到非試撮狀態並省略此欄位。欄位語意與 trades／books 頻道一致，但送達版本不同：aggregates 頻道在 v1.0 與 v1.1 連線皆會推送試撮期間的更新；trades／books 的試撮訊息僅 v1.1 推送。

Example

Subscribe channel

Python

from fugle_marketdata import WebSocketClient

def handle_message(message):
    print(message)

def main():
    client = WebSocketClient(api_key='YOUR_API_KEY')
    futopt = client.futopt
    futopt.on('message', handle_message)
    futopt.connect()
    futopt.subscribe({ 
        'channel': 'aggregates', 
        'symbol': 'TXFK4',
        'afterHours': True
    })

if __name__ == '__main__':
    main()

Node.js

const { WebSocketClient } = require("@fugle/marketdata");

const client = new WebSocketClient({ apiKey: "YOUR_API_KEY" });

const futopt = client.futopt;

futopt.connect().then(() => {
  futopt.subscribe({ channel: "aggregates", symbol: "TXFK4", afterHours: true });
});

futopt.on("message", (message) => {
  const data = JSON.parse(message);
  console.log(data);
});

Receive data

{
  "event": "data",
  "data": {
    "date": "2024-10-23",
    "type": "FUTURE_AH",
    "exchange": "TAIFEX",
    "symbol": "TXFK4",
    "name": "臺股期貨114",
    "previousClose": 23660,
    "openPrice": 23611,
    "openTime": 1729580400097000,
    "highPrice": 23667,
    "highTime": 1729581260165000,
    "lowPrice": 23598,
    "lowTime": 1729580555065000,
    "closePrice": 23620,
    "closeTime": 1729582381863000,
    "avgPrice": 23631.9,
    "change": -1,
    "changePercent": 0,
    "amplitude": 0.29,
    "lastPrice": 23620,
    "lastSize": 1,
    "total": {
      "tradeVolume": 2854,
      "totalBidMatch": 2493,
      "totalAskMatch": 2484,
      "time": 1729582381863000
    },
    "lastTrade": {
      "bid": 23620,
      "ask": 23622,
      "price": 23620,
      "size": 1,
      "time": 1729582381863000,
      "serial": "00010204"
    },
    "lastTrial": {
      "bid": 23609,
      "ask": 23612,
      "price": 23611,
      "size": 1,
      "time": 1729580399000000,
      "serial": "00000003"
    },
    "serial": 158638,
    "lastUpdated": 1729582383094000
  },
  "id": "<CHANNEL_ID>",
  "channel": "aggregates"
}