Trades

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

Parameters

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

Response

Name	Type	Description
symbol*	string	商品代號
type*	string	Ticker 類型
exchange*	string	交易所
market	string	市場別
trades	object	成交報價
>> price	number	成交價格
>> size	number	成交單量
>> bid	number	成交買價
>> ask	number	成交賣價
total	object	成交量
>> tradeVolume	number	成交總量
>> totalBidMatch	number	累積內盤成交量
>> totalAskMatch	number	累積外盤成交量
time*	number	時間
serial*	number	流水號

info

'*' 表示必揭示欄位。

Example

Subscribe channel

Python

from fubon_neo.sdk import FubonSDK, Order

def handle_message(message):
    print(f'market data message: {message}')

sdk = FubonSDK()
accounts = sdk.login("Your ID", "Your password", "Your cert path", "Your cert password")  # 需登入後，才能取得行情權限

sdk.init_realtime() # 建立行情連線

futopt = sdk.marketdata.websocket_client.futopt
futopt.on('message', handle_message)
futopt.connect()
futopt.subscribe({ 
    'channel': 'trades', 
    'symbol': 'TXFA4'
    #'afterHours' : True   # 夜盤行情
})

Node.js

const { FubonSDK } = require('fubon-neo');

const sdk = new FubonSDK();

const accounts = sdk.login("Your ID", "Your password", "Your cert path", "Your cert password");

sdk.initRealtime(); // 建立行情連線

const futopt = sdk.marketdata.webSocketClient.futopt;

futopt.connect().then(() => {
  futopt.subscribe({ 
                     channel: "trades",
                     symbol: "TXFA4"
                     // afterHours: true    //夜盤行情 
                    });
});

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

C#

using FubonNeo.Sdk;

var sdk = new FubonSDK();

var result = sdk.Login("Your ID", "Your password", "Your cert path", "Your cert password");

sdk.InitRealtime();  // 建立行情連線

var futopt = sdk.MarketData.WebSocketClient.FutureOption;

futopt.OnMessage += (msg) => Console.WriteLine($"receive: { msg }");

await futopt.Connect();

await futopt.Subscribe(FugleMarketData.WebsocketModels.FutureOptionChannel.Trades, "TXFA4");

// await futopt.Subscribe(FugleMarketData.WebsocketModels.FutureOptionChannel.Trades,  new FutureOptionParams { Symbol = "TXFC4", AfterHours = true });  // 夜盤行情

Receive data

{
    "event": "data",
    "data": {
        "symbol": "TXFA4",
        "type": "FUTURE",
        "exchange": "TAIFEX",
        "trades": [
          {
            "price": 17540,
            "size": 1,
            "bid": 17539,
            "ask": 17540
          }
        ],
        "total": {
            "tradeVolume": 12174,
            "totalBidMatch": 8760,
            "totalAskMatch": 7907
        },
        "time": 1702956487023000,
        "serial": 159250
    },
    "id": "<CHANNEL_ID>",
    "channel": "trades"
}