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	交易所
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	最後成交價漲跌
changePercnet	number	最後成交價漲跌幅
amplitude	number	當日振幅
lastPrice	number	最後一筆成交價（含試撮）
lastSize	number	最後一筆成交數量（含試撮）
total	object	統計時間
total.tradeVolume	number	累計成交量
total.totalBidMatch	number	累計委買成交筆數
total.totalAskMatch	number	累計委賣成交筆數
lastTrade	object	最後一筆成交資訊
lastTrade.price	number	最後一筆成交價格
lastTrade.size	number	最後一筆成交數量
lastTrade.time	number	最後一筆成交時間
lastTrade.serial	number	最後一筆成交流水號
serial	number	流水號
lastUpdated	number	最後異動時間

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;

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

stock.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"
    },
    "serial": 158638,
    "lastUpdated": 1729582383094000
  },
  "id": "<CHANNEL_ID>",
  "channel": "aggregates"
}