Skip to main content

Intraday Tickers BETA

取得期權可交易商品列表(依條件查詢)

GET /intraday/tickers

Parameters​

NameTypeDescription
type*string類型,可選 FUTURE 期貨 ; OPTION 選擇權
exchangestring交易所,可選 TAIFEX 臺灣期貨交易所
sessionstring交易時段,可選 REGULAR 一般交易 或 AFTERHOURS 盤後交易
productstring契約代碼
contractTypestring契約類別,可選 I 指數類;R 利率類;B 債券類;C 商品類;S 股票類;E 匯率類
isSpreadboolean帶 true 回傳時間價差(calendar spread)契約清單;預設回傳一般契約。時間價差僅存在於期貨(type=FUTURE),選擇權無此類契約

Response​

NameTypeDescription
type*string期權類型
exchange*string交易所
sessionstring交易時段
productstring契約代碼
contractTypestring契約類別
isSpreadboolean是否為價差契約查詢(帶 isSpread=true 時為 true;未帶或帶 false 時不出現此欄位)
data*object[]商品列表
data[0].typestring期權類型
data[0].symbolstring商品代碼
data[0].namestring商品名稱
data[0].referencePricenumber參考價
data[0].limitUpPricenumber漲停價
data[0].limitDownPricenumber跌停價
data[0].priceLimitLevelsobject[]各階漲跌停價(限適用分階漲跌幅的商品)
data[0].priceLimitLevels[].levelnumber階數,1 為基準階
data[0].priceLimitLevels[].limitUpPricenumber該階漲停價
data[0].priceLimitLevels[].limitDownPricenumber該階跌停價
data[0].limitUpLevelnumber漲停目前適用階數(限適用分階漲跌幅的商品)
data[0].limitDownLevelnumber跌停目前適用階數(限適用分階漲跌幅的商品)
data[0].contractTypestring契約類別
data[0].startDatestring上市日期
data[0].endDatestring下市日期
data[0].openDatetimestring交易時段開始時間
data[0].closeDatetimestring交易時段結束時間
data[0].flowGroupstring流程群組
data[0].settlementDatestring最後結算日
data[0].isDynamicBandingboolean是否適用動態價格穩定
data[0].isSpreadboolean是否為價差契約(價差契約為 true,一般契約不出現此欄位)
info

臺股期貨、個股期貨等單一漲跌幅商品僅回傳 limitUpPrice 與 limitDownPrice。黃金、原油、匯率、國外指數及國外成分證券 ETF 的期貨與選擇權採分階漲跌幅,另回傳 priceLimitLevels 完整階梯與 limitUpLevel/limitDownLevel 目前適用階數,此時 limitUpPrice/limitDownPrice 為目前適用階數的價格;盤中漲跌幅放寬後,適用階數與漲跌停價會隨之更新,且漲停與跌停可能適用不同階數。

info

帶 isSpread=true 查詢價差契約時,data 回傳的欄位較精簡(symbol、type、name、isSpread)。詳見下方「價差契約」。

Example​

curl -X 'GET' \
'https://api.fugle.tw/marketdata/v1.0/futopt/intraday/tickers?type=FUTURE&exchange=TAIFEX&session=REGULAR&product=TXF' \
-H 'X-API-KEY: <YOUR_API_KEY>'

Response Body:

{
"type": "FUTURE",
"exchange": "TAIFEX",
"session": "REGULAR",
"product": "TXF",
"data": [
{
"symbol": "TXFC7",
"type": "FUTURE",
"closeDatetime": "2026-09-09T13:45:00.000+08:00",
"contractType": "I",
"endDate": "2027-03-17",
"flowGroup": 1,
"isDynamicBanding": true,
"name": "臺股期貨037",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 47916,
"settlementDate": "2027-03-17",
"startDate": "2026-03-19",
"limitDownPrice": 43125,
"limitUpPrice": 52707
},
{
"symbol": "TXFF7",
"type": "FUTURE",
"closeDatetime": "2026-09-09T13:45:00.000+08:00",
"contractType": "I",
"endDate": "2027-06-16",
"flowGroup": 1,
"isDynamicBanding": true,
"name": "臺股期貨067",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 48426,
"settlementDate": "2027-06-16",
"startDate": "2026-06-18",
"limitDownPrice": 43584,
"limitUpPrice": 53268
},
{
"symbol": "TXFI6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T13:45:00.000+08:00",
"contractType": "I",
"endDate": "2026-09-16",
"flowGroup": 1,
"isDynamicBanding": true,
"name": "臺股期貨096",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 46955,
"settlementDate": "2026-09-16",
"startDate": "2025-09-18",
"limitDownPrice": 42260,
"limitUpPrice": 51650
},
{
"symbol": "TXFJ6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T13:45:00.000+08:00",
"contractType": "I",
"endDate": "2026-10-21",
"flowGroup": 1,
"isDynamicBanding": true,
"name": "臺股期貨106",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 47131,
"settlementDate": "2026-10-21",
"startDate": "2026-07-16",
"limitDownPrice": 42418,
"limitUpPrice": 51844
},
{
"symbol": "TXFK6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T13:45:00.000+08:00",
"contractType": "I",
"endDate": "2026-11-18",
"flowGroup": 1,
"isDynamicBanding": true,
"name": "臺股期貨116",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 47280,
"settlementDate": "2026-11-18",
"startDate": "2026-08-20",
"limitDownPrice": 42552,
"limitUpPrice": 52008
},
{
"symbol": "TXFL6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T13:45:00.000+08:00",
"contractType": "I",
"endDate": "2026-12-16",
"flowGroup": 1,
"isDynamicBanding": true,
"name": "臺股期貨126",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 47414,
"settlementDate": "2026-12-16",
"startDate": "2025-12-18",
"limitDownPrice": 42673,
"limitUpPrice": 52155
}
]
}

分階漲跌幅商品​

curl -X 'GET' \
'https://api.fugle.tw/marketdata/v1.0/futopt/intraday/tickers?type=FUTURE&exchange=TAIFEX&session=REGULAR&product=OAF' \
-H 'X-API-KEY: <YOUR_API_KEY>'

Response Body:

{
"type": "FUTURE",
"exchange": "TAIFEX",
"session": "REGULAR",
"product": "OAF",
"data": [
{
"symbol": "OAFC7",
"type": "FUTURE",
"closeDatetime": "2026-09-09T16:15:00.000+08:00",
"contractType": "S",
"endDate": "2027-03-17",
"flowGroup": 5,
"isDynamicBanding": true,
"name": "富邦上証ETF期貨037",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 40.2,
"settlementDate": "2027-03-17",
"startDate": "2026-04-16",
"limitDownLevel": 1,
"limitDownPrice": 37.39,
"limitUpLevel": 1,
"limitUpPrice": 43.01,
"priceLimitLevels": [
{
"level": 1,
"limitUpPrice": 43.01,
"limitDownPrice": 37.39
},
{
"level": 2,
"limitUpPrice": 44.22,
"limitDownPrice": 36.18
},
{
"level": 3,
"limitUpPrice": 46.23,
"limitDownPrice": 34.17
}
]
},
{
"symbol": "OAFF7",
"type": "FUTURE",
"closeDatetime": "2026-09-09T16:15:00.000+08:00",
"contractType": "S",
"endDate": "2027-06-16",
"flowGroup": 5,
"isDynamicBanding": true,
"name": "富邦上証ETF期貨067",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 39.97,
"settlementDate": "2027-06-16",
"startDate": "2026-07-16",
"limitDownLevel": 1,
"limitDownPrice": 37.18,
"limitUpLevel": 1,
"limitUpPrice": 42.76,
"priceLimitLevels": [
{
"level": 1,
"limitUpPrice": 42.76,
"limitDownPrice": 37.18
},
{
"level": 2,
"limitUpPrice": 43.96,
"limitDownPrice": 35.98
},
{
"level": 3,
"limitUpPrice": 45.96,
"limitDownPrice": 33.98
}
]
},
{
"symbol": "OAFI6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T16:15:00.000+08:00",
"contractType": "S",
"endDate": "2026-09-16",
"flowGroup": 5,
"isDynamicBanding": true,
"name": "富邦上証ETF期貨096",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 40.53,
"settlementDate": "2026-09-16",
"startDate": "2025-10-16",
"limitDownLevel": 1,
"limitDownPrice": 37.7,
"limitUpLevel": 1,
"limitUpPrice": 43.36,
"priceLimitLevels": [
{
"level": 1,
"limitUpPrice": 43.36,
"limitDownPrice": 37.7
},
{
"level": 2,
"limitUpPrice": 44.58,
"limitDownPrice": 36.48
},
{
"level": 3,
"limitUpPrice": 46.6,
"limitDownPrice": 34.46
}
]
},
{
"symbol": "OAFJ6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T16:15:00.000+08:00",
"contractType": "S",
"endDate": "2026-10-21",
"flowGroup": 5,
"isDynamicBanding": true,
"name": "富邦上証ETF期貨106",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 40.4,
"settlementDate": "2026-10-21",
"startDate": "2026-08-20",
"limitDownLevel": 1,
"limitDownPrice": 37.58,
"limitUpLevel": 1,
"limitUpPrice": 43.22,
"priceLimitLevels": [
{
"level": 1,
"limitUpPrice": 43.22,
"limitDownPrice": 37.58
},
{
"level": 2,
"limitUpPrice": 44.44,
"limitDownPrice": 36.36
},
{
"level": 3,
"limitUpPrice": 46.46,
"limitDownPrice": 34.34
}
]
},
{
"symbol": "OAFL6",
"type": "FUTURE",
"closeDatetime": "2026-09-09T16:15:00.000+08:00",
"contractType": "S",
"endDate": "2026-12-16",
"flowGroup": 5,
"isDynamicBanding": true,
"name": "富邦上証ETF期貨126",
"openDatetime": "2026-09-09T08:45:00.000+08:00",
"referencePrice": 40.27,
"settlementDate": "2026-12-16",
"startDate": "2026-01-22",
"limitDownLevel": 1,
"limitDownPrice": 37.46,
"limitUpLevel": 1,
"limitUpPrice": 43.08,
"priceLimitLevels": [
{
"level": 1,
"limitUpPrice": 43.08,
"limitDownPrice": 37.46
},
{
"level": 2,
"limitUpPrice": 44.29,
"limitDownPrice": 36.25
},
{
"level": 3,
"limitUpPrice": 46.31,
"limitDownPrice": 34.23
}
]
}
]
}

價差契約​

時間價差(calendar spread)契約預設不會出現在清單中,帶 isSpread=true 才會回傳。價差契約有以下特性:

  • 代碼格式為 {近月}/{遠月}:由近、遠兩腳合約組成,契約名稱標示兩個月份(例如 電子期貨076-086)。同商品的跨月價差,遠腳省略商品代碼(例如 EXFG6/H6、TXFG6/H6);兩腳商品代碼不同時(如週契約與月契約組成的價差),遠腳為完整代碼(例如 MX4G6/MXFH6)。
  • 依代碼查詢時斜線直接放入路徑:/intraday/ticker/{symbol}、/intraday/quote/{symbol} 等依代碼查詢端點支援價差代碼,代碼中的 / 以未編碼的斜線直接放入路徑即可(例如 /intraday/quote/TXFG6/H6)。也可透過 WebSocket 訂閱(將價差代碼放在訂閱訊息的 symbol 欄位)。
  • 報價可為負值:價差為兩腳合約的價格之差,買賣報價可能為負數,屬正常現象。
  • 不需等成交即可查得:價差契約清單於每日商品檔初始化時預先建立,開盤前或尚無成交的價差契約也會出現在清單中。
  • 日盤與夜盤皆有:一般交易與盤後交易時段皆有價差契約行情。
curl -X 'GET' \
'https://api.fugle.tw/marketdata/v1.0/futopt/intraday/tickers?type=FUTURE&exchange=TAIFEX&session=AFTERHOURS&isSpread=true' \
-H 'X-API-KEY: <YOUR_API_KEY>'

Response Body:

{
"type": "FUTURE",
"exchange": "TAIFEX",
"session": "AFTERHOURS",
"isSpread": true,
"data": [
{
"symbol": "EXFG6/H6",
"type": "FUTURE_AH",
"isSpread": true,
"name": "電子期貨076-086"
}
]
}