AI agent？先讀 /llms.txt 取得全站索引。

衍生與可轉債

期貨市場日資料

Name: Futures market (daily)
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

期交所期貨日資料。實體是「契約」而非個股:以契約代碼查詢(symbol=TX),帶股票代號查不到。

← 期貨市場日資料資料集總覽

已驗證來源: TAIFEX·方案: max·計費: 2 點·GET /v2/datasets/derivatives-market

期貨市場日資料是台灣市場資料集,來源為 TAIFEX,由 TW Market Data 以 GET /v2/datasets/derivatives-market 提供。

總覽

每個契約每日一列。`contract_code` 就是查詢用的 `symbol`(例如台指期為 TX);帶股票代號會查不到,因為沒有那個契約。`derivative_type=options` 回 0 列是正常的——本資料集收的是期貨,那個查詢回空是誠實的答案,不是故障。

欄位	型別	說明
`contract_code`	string
`symbol`	string
`as_of_date`	string
`derivative_type`	string
`contract_type`	string
`open_interest`	null	未平倉量。
`volume`	number
`settlement_price`	null	每日結算價。
`open`	number
`high`	number
`low`	number
`close`	number
`market`	string

涵蓋範圍

列數	約 6,001,093
涵蓋起訖	1998-07-21 – 2026-09-04
分級	已驗證
量測時間	2026-09-01取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/derivatives-market",
  "request_id": "req_178597f48cb0",
  "plan_id": "enterprise",
  "dataset": "derivatives_market",
  "query": {
    "symbol": "TX",
    "contract_code": null,
    "as_of_date": null,
    "start_date": null,
    "end_date": null,
    "market": null,
    "derivative_type": null,
    "contract_type": null,
    "limit": 50,
    "legacy_aliases_used": {
      "date_from": false,
      "date_to": false,
      "contract": false,
      "dataset_name": false,
      "offset": false,
      "sort_by": false,
      "sort_order": false
    }
  },
  "meta": {
    "rows_returned": 50,
    "mandatory_contract_fields_present": [
      "api_version",
      "data",
      "data_as_of"
    ],
    "plan": "enterprise",
    "row_limit": 100000,
    "is_limited": false
  },
  "envelope": {
    "api_version": "v2",
    "dataset": "derivatives_market",
    "dataset_version": "v2.0.0-preview",
    "release_version": "v2.2026-08-05.preview",
    "release_date": "2026-08-05",
    "data_as_of": "2026-08-05",
    "request_context": {
      "ticker": "TX",
      "as_of_date": "2026-08-05",
      "family": "derivatives_daily",
      "field_group_type": "derived",
      "dataset_view": "taifex_futures_daily_v1",
      "scope": "futures_only"
    },
    "data": [
      {
        "contract_code": "TX",
        "symbol": "TX",
        "as_of_date": "2026-08-05",
        "derivative_type": "futures",
        "contract_type": "202706",
        "open_interest": null,
        "volume": 1,
        "settlement_price": null,
        "open": 46230,
        "high": 46230,
        "low": 46230,
        "close": 46230,
        "market": "TAIFEX",
        "source_name": "taifex_official",
        "source_url": null
      },
      {
        "contract_code": "TX",
        "symbol": "TX",
        "as_of_date": "2026-08-05",
        "derivative_type": "futures",
        "contract_type": "202706",
        "open_interest": 61,
        "volume": 7,
        "settlement_price": 46220,
        "open": 46479,
        "high": 46612,
        "low": 46479,
        "close": 46612,
        "market": "TAIFEX",
        "source_name": "taifex_official",
        "source_url": null
      }
    ],
    "quality": {
      "freshness_state": "fresh",
      "freshness_as_of": "2026-08-05",
      "completeness_ratio": 1,
      "quality_status": "ready"
    },
    "lineage": {
      "source_role": "canonical",
      "selected_source": "derivatives_market",
      "fallback_chain": [],
      "policy_notes": [
        "TAIFEX 期貨日 (futures daily) — official source",
        "FUTURES ONLY: options are not served here (the daily-options table is unpopulated); an options/derivative_type filter returns no rows rather than faked data",
        "contract == symbol == contract_code; market is TAIFEX"
      ]
    },
    "error": {
      "error_code": null,
      "error_message": null,
      "dataset": "derivatives_market",
      "request_id": "read-api-2d9aeb737486",
      "blocking_gate": null
    }
  }
}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_namesource_url

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 期貨市場日資料 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/derivatives/derivatives-market

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

GHG 碳揭露（範疇1/2/3）
可用 as_of_date + market + ticker 對齊
財務比率指標
可用 as_of_date + market + ticker 對齊
三大法人買賣
可用 as_of_date + market + ticker 對齊
發行人分類
可用 as_of_date + market + ticker 對齊
融資融券
可用 as_of_date + market + ticker 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 envelope.data 陣列。

curl "https://api.twmarketdata.com/v2/datasets/derivatives-market?dataset_name=taifex_txf_front" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`dataset_name`	否	string	子資料集名稱，例如 taifex_txf_front。

Python 範例

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()["envelope"]["data"])

OpenAPI

此端點為 GET /v2/datasets/derivatives-market。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

本頁先發佈以記錄端點。即時數字刻意留白,直到以具權限金鑰實際量測——不顯示任何佔位數值。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/derivatives-market" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/derivatives-market",
  "request_id": "req_178597f48cb0",
  "plan_id": "enterprise",
  "dataset": "derivatives_market",
  "query": {
    "symbol": "<string>",
    "contract_code": "<null>",
    "as_of_date": "<null>",
    "start_date": "<null>",
    "end_date": "<null>",
    "market": "<null>",
    "derivative_type": "<null>",
    "contract_type": "<null>",
    "limit": "<number>",
    "legacy_aliases_used": {
      "date_from": "<boolean>",
      "date_to": "<boolean>",
      "contract": "<boolean>",
      "dataset_name": "<boolean>",
      "offset": "<boolean>",
      "sort_by": "<boolean>",
      "sort_order": "<boolean>"
    }
  },
  "meta": {
    "rows_returned": "<number>",
    "mandatory_contract_fields_present": "<array>",
    "plan": "<string>",
    "row_limit": "<number>",
    "is_limited": "<boolean>"
  },
  "envelope": {
    "api_version": "<string>",
    "dataset": "<string>",
    "dataset_version": "<string>",
    "release_version": "<string>",
    "release_date": "<string>",
    "data_as_of": "<string>",
    "request_context": {
      "ticker": "<string>",
      "as_of_date": "<string>",
      "family": "<string>",
      "field_group_type": "<string>",
      "dataset_view": "<string>",
      "scope": "<string>"
    },
    "data": "<array>",
    "quality": {
      "freshness_state": "<string>",
      "freshness_as_of": "<string>",
      "completeness_ratio": "<number>",
      "quality_status": "<string>"
    },
    "lineage": {
      "source_role": "<string>",
      "selected_source": "<string>",
      "fallback_chain": "<array>",
      "policy_notes": "<array>"
    },
    "error": {
      "error_code": "<null>",
      "error_message": "<null>",
      "dataset": "<string>",
      "request_id": "<string>",
      "blocking_gate": "<null>"
    }
  }
}