Trades BETA

接收訂閱期權商品最新成交資訊

Parameters

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

Response

Name	Type	Description
symbol*	string	商品代號
type*	string	Ticker 類型
exchange*	string	交易所
trades	object[]	成交報價
trades[0].price	number	成交價格
trades[0].size	number	成交單量
trades[0].bid	number	成交買價
trades[0].ask	number	成交賣價
total	object	成交量
total.tradeVolume	number	成交總量
total.totalBidMatch	number	累計委買成交筆數
total.totalAskMatch	number	累計委賣成交筆數
time*	number	時間
serial*	number	流水號
isTrial	boolean	試撮階段為 true，非試撮時省略此欄位（缺省視為 false）；試撮訊息僅 /v1.1/futopt/streaming 連線推送，v1.0 恆不推送

試撮訊息

isTrial: true 時，trades[] 的內容為試撮撮合結果而非實際成交，請勿計入成交統計：

• 試撮訊息不累計統計量，total.tradeVolume／total.totalBidMatch／total.totalAskMatch 均為 0。
• 試撮未撮合出價格時，price 與 size 為 0，代表該次試撮無成交，並非成交價為 0。

此頻道的試撮訊息僅 v1.1 連線會推送；但 aggregates 頻道在 v1.0 也會推送試撮期間的更新，兩者判斷方式不同，請留意。

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': 'trades', 
      'symbol': 'TXFG4',
      '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: "trades", symbol: "TXFG4", afterHours: true });
});

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

Receive data

{
  "event": "data",
  "data": {
    "symbol": "TXFG4",
    "type": "FUTURE_AH",
    "exchange": "TAIFEX",
    "trades": [
      {
        "price": 23379,
        "size": 1,
        "bid": 23379,
        "ask": 23380
      }
    ],
    "total": {
      "tradeVolume": 12431,
      "totalBidMatch": 8191,
      "totalAskMatch": 7964
    },
    "time": 1718880340342000,
    "serial": 23143
  },
  "id": "<CHANNEL_ID>",
  "channel": "trades"
}