開始使用

台新行情 Web API 提供開發者友善的 API 服務。您可以查詢日內行情、行情快照與歷史行情等數據。

速率限制

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

功能列表

功能列表依資料類型可分為 盤中行情（intraday）、行情快照（snapshot）、歷史行情（historical）。台新行情 Web API 提供的功能如下：

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

商品代碼與連續月別名

期貨選擇權商品可使用具體合約代碼（含月份碼，如 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 近月）三種連續月別名。

以連續月別名查詢報價（restfut.intraday.quote(symbol='TXF1!')），回傳的 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 。您可以透過以下方式存取 API：

Python

from taishin_sdk import TaishinSDK, Order

sdk = TaishinSDK()

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

sdk.init_realtime(accounts[0])  # 建立行情連線

restfutopt = sdk.marketdata.rest_client.futopt  

Node.js

const { TaishinSDK } = require('taishin-sdk');

const sdk = new TaishinSDK();

const accounts = sdk.login("Your ID", "Your Password", "Your Cert Path", "Your Cert Password");

sdk.initRealtime(accounts[0]); // 建立行情連線

const client = sdk.marketdata.restClient

const futopt = client.futopt;