AI agent？先讀 /llms.txt 取得全站索引。
衍生與可轉債
TAIFEX 期貨市場資料——上市期貨契約的每日結算、成交量與未平倉量。
GET /v2/datasets/derivatives-marketderivatives-market 回傳 TAIFEX 期貨每日紀錄,來源為官方交易所資料。涵蓋自 1990 年代末起,每日更新。
| 欄位 | 型別 | 說明 |
|---|---|---|
contract | string | 期貨契約代碼。 |
date | string | 交易日。 |
settlement_price | number | 每日結算價。 |
open_interest | number | 未平倉量。 |
source_role | string | official_taifex。 |
| 列數 | 5,960,037 |
| 涵蓋起訖 | 1998-07-21 至 2026-07-16 |
| 分級 | 已驗證 |
TODO —— 尚未擷取到此資料集的真實回應（需要有權限的 API 金鑰，或其必填參數尚未確認）。寧可留白，也不顯示未經實測的範例。
curl "https://api.twmarketdata.com/v2/datasets/derivatives-market?dataset_name=taifex_txf_front" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/derivatives-market", params={"dataset_name": "taifex_txf_front"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/derivatives-market", params={"dataset_name": "taifex_txf_front"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())此端點為 GET /v2/datasets/derivatives-market。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。