Intraday Trades

期權成交明細（依代碼查詢）

intraday/trades/{symbol}

Parameters

Name	Type	Description
symbol*	string	期權代碼
session	string	交易時段，可選 afterhours 夜盤
offset	number	偏移量
limit	number	限制量
isTrial	boolean	查詢試撮明細，預設 false（回傳正式成交）

Response

Name	Type	Description
date*	string	日期
type*	string	期權類型
exchange*	string	交易所
market	string	市場別
symbol*	string	商品代號
data*	object[]	成交明細
>> price	number	成交價格
>> size	number	成交單量
>> time	number	成交時間

info

'*' 表示必揭示欄位。

試撮查詢

isTrial=true 用於查詢試撮階段（盤前試撮揭示）之成交明細；預設（false）僅回傳正式撮合之成交明細，兩者為獨立查詢模式而非同一結果混合旗標。此參數隨期權進階行情功能分階段啟用；未啟用前查詢 isTrial=true 之行為以正式公告為準。

Example

Python

from fubon_neo.sdk import FubonSDK, Order

sdk = FubonSDK()

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

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

restfutopt = sdk.marketdata.rest_client.futopt 
# restfutopt.intraday.trades(symbol='TXFA4')  # 2.2.3 及以前版本

## 2.2.4 及以後版本 (使用 Exception 進行例外處理)
from fubon_neo.fugle_marketdata.rest.base_rest import FugleAPIError

try:  
  restfutopt.intraday.trades(symbol='TXFA4')
except FugleAPIError as e:
  print(f"Error: {e}")
  print("------------")
  print(f"Status Code: {e.status_code}")  # 例: 429
  print(f"Response Text: {e.response_text}")  # 例: {"statusCode":429,"message":"Rate limit exceeded"}     

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 client = sdk.marketdata.restClient
client.futopt.intraday.trades({ symbol: 'TXFA4' })
  .then(data => 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 rest = sdk.MarketData.RestClient.FutureOption;

var trade = await rest.Intraday.Trades("TXFA4");
// var trade = await rest.Intraday.Trades("TXFA4", new(){Session=FugleMarketData.QueryModels.FuOpt.TradeSession.AfterHours});  // 盤後交易

var trade_cont = trade.Content.ReadAsStringAsync().Result;

Console.WriteLine(trade_cont);

Response Body：

{
    "date": "2023-12-20",
    "type": "FUTURE",
    "exchange": "TAIFEX",
    "symbol": "TXFA4",
    "data": [
        {
            "price": 17660,
            "size": 3,
            "time": 1703051099834000,
            "serial": 218307
        },
        {
            "price": 17661,
            "size": 2,
            "time": 1703051099779000,
            "serial": 218304
        },
        {
            "price": 17661,
            "size": 1,
            "time": 1703051099778000,
            "serial": 218303
        },
        {
            "price": 17661,
            "size": 1,
            "time": 1703051099778000,
            "serial": 218301
        },
        ....
    ]
}