Skip to main content

開始使用 BETA

富果行情 REST API 提供開發者友善的 Web API 服務。您可以查詢台股期貨選擇權的日內行情與歷史行情等數據。

身份驗證​

富果行情 API 透過 API 金鑰對用戶進行身份驗證（Authentication）。請在發送 API 請求時請加入以下 HTTP 標頭：

X-API-KEY: <YOUR_API_KEY>

速率限制​

如果您 API 請求超過了限制，將收到帶有狀態碼 429 的回應。

不同的 API 方案有不同的速率限制，關於速率限制，請參考 行情方案及價格 的說明。

API 端點​

富果行情 REST API 端點使用以下位置為前綴：

https://api.fugle.tw/marketdata/v1.0/futopt/
info

富果期權行情 REST API 僅有 v1.0 版本；試撮相關資料（lastTrial、頂層 isTrial、trades?isTrial=true）於 v1.0 即可取得，不需切換版本。v1.1 只存在於 WebSocket，且僅影響 trades／books 頻道是否推送試撮訊息，詳見 WebSocket API。

富果行情 REST API 目前提供的端點如下：

商品代碼與連續月別名​

期貨選擇權商品可使用具體合約代碼（含月份碼，如 TXFG6）查詢；富果另外提供連續月別名，方便您持續追蹤特定近月合約，不需自行換月。

別名說明
{ROOT}1!第 1 近月（最近月）合約
{ROOT}2!第 2 近月（次近月）合約
{ROOT}3!第 3 近月合約
  • {ROOT} 為商品根代碼，例如臺股期貨為 TXF，故 TXF1! 代表最近月臺股期貨。
  • 系統會自動將別名解析（resolve）為當前對應的具體合約（例如 TXF1! → TXFG6），最後交易日當天別名仍指向該到期合約，次一交易日起自動切換（rollover）至新的近月；回傳資料中的 symbol 為解析後的具體合約代碼。
  • 連續月別名可作為 {symbol} 用於 /intraday/ticker、/intraday/quote、/intraday/candles、/intraday/trades、/intraday/volumes 端點，以及 WebSocket 各訂閱頻道。
  • 連續月別名不會出現在 /intraday/products、/intraday/tickers 等清單回應中，需直接以別名查詢。
  • 目前提供 1!／2!／3!（第 1～3 近月）三種連續月別名。

以連續月別名查詢報價，回傳的 symbol 為解析後的具體合約：

curl -X 'GET' \
  'https://api.fugle.tw/marketdata/v1.0/futopt/intraday/quote/TXF1!' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

Response Body（節錄）：

{
  "date": "2026-07-03",
  "type": "FUTURE",
  "exchange": "TAIFEX",
  "symbol": "TXFG6",
  "name": "臺股期貨076",
  "previousClose": 46599,
  "openPrice": 45700,
  "lastPrice": 46510
}

使用 SDK​

富果行情 Web API 提供 Python 、 Node.js SDK 。您可以透過以下方式存取 API：

from fugle_marketdata import RestClient

client = RestClient(api_key = 'YOUR_API_KEY')
futopt = client.futopt
futopt.intraday.quote(symbol='TXF1!')  # 以連續月別名查詢最近月臺股期貨報價
Last updated on