開始使用

本頁重點

富邦行情期貨 Web API（富邦新一代 API 期貨行情服務）提供期貨與期權日內資料、期貨歷史Ｋ線查詢。
超過速率限制會回應 429。
提供 Python / Node.js / C# SDK 範例。
下一步可從功能列表選擇對應 API 端點。

項目	說明
介面	Web API
市場	期貨 / 期權
資料類型	日內 / 歷史
速率限制	超過回應 `429`
SDK	Python / Node.js / C#

富邦行情 Web API 提供開發者友善的 API 服務。您可以查詢期貨與期權日內行情、期貨歷史Ｋ線等數據。

速率限制

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

功能列表

富邦行情期貨 Web API 提供的功能如下：

/intraday/products - 期權契約列表（依條件查詢）
/intraday/tickers - 期權商品列表（依條件查詢）
/intraday/quote/{symbol} - 期貨即時報價（依代碼查詢）
/intraday/candles/{symbol} - 期貨價格Ｋ線（依代碼查詢）
/intraday/trades/{symbol} - 期貨成交明細（依代碼查詢）
/intraday/volumes/{symbol} - 期貨分價量表（依代碼查詢）
/historical/candles/{product} - 期貨歷史Ｋ線（依商品代號查詢）

商品代碼與連續月別名

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

別名	說明
`{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 近月）三種連續月別名。
歷史Ｋ線端點 /historical/candles 以商品代號查詢，連續合約改由 contractMonth 參數指定（1!／2!／3!），回傳的每根Ｋ線會標示實際所屬的契約月份。

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

Python
Node.js

restfutopt.intraday.quote(symbol='TXF1!')  # 以連續月別名查詢最近月臺股期貨報價

futopt.intraday.quote({ symbol: 'TXF1!' }); // 以連續月別名查詢最近月臺股期貨報價

Response Body（節錄，symbol 已解析為具體合約）：

{
  "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 與 C# SDK。您可以透過以下方式存取 API：

Python
Node.js
C#

from fubon_neo.sdk import FubonSDK, Order
# 2.2.4 以後版本, 增加下列匯入: 
# from fubon_neo.fugle_marketdata.rest.base_rest import FugleAPIError

sdk = FubonSDK()

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

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

restfutopt = sdk.marketdata.rest_client.futopt  

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

const futopt = client.futopt;

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;

速率限制​

功能列表​

商品代碼與連續月別名​

使用 SDK​

速率限制

功能列表

商品代碼與連續月別名

使用 SDK