Candles

接收訂閱期權商品最新分鐘Ｋ

Parameters

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

Response

Name	Type	Description
date*	string	日期
type*	string	Ticker 類型
exchange*	string	交易所
market	string	市場別
symbol*	string	股票代號
timeframe*	number	Ｋ線週期
open*	number	Ｋ線開盤價
high*	number	Ｋ線最高價
low*	number	Ｋ線最低價
close*	number	Ｋ線收盤價
volume*	number	Ｋ線成交量（整股：成交張數；興櫃股票及盤中零股：成交股數；指數：成交金額）
average*	number	成交均價

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(Mode.Normal) # 建立行情連線

futopt = sdk.marketdata.websocket_client.futopt
futopt.on('message', handle_message)
futopt.connect()
futopt.subscribe({ 
    'channel': 'candles', 
    'symbol': 'TXFA4'
})

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(Mode.Normal); // 建立行情連線

const futopt = sdk.marketdata.webSocketClient.futopt;

futopt.connect().then(() => {
  futopt.subscribe({ channel: "candles", symbol: "TXFA4" });
});

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(Mode.Normal);  // 建立行情連線

var futopt = sdk.MarketData.WebSocketClient.FutureOption;

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

await futopt.Connect();

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

Receive data

{
    "event": "data",
    "data": {
        "symbol": "TXFA4",
        "type": "FUTURE",
        "exchange": "TAIFEX",
        "date": "2023-12-28T12:01:00.000+08:00",
        "open": 17861,
        "high": 17862,
        "low": 17859,
        "close": 17862,
        "volume": 22,
        "average": 17820.19
    },
    "id": "<CHANNEL_ID>",
    "channel": "candles"
}