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

籌碼與資金

融券強制回補日

融券強制回補日

已驗證來源: TWSE·方案: pro·計費: 2 ·GET /v2/datasets/margin-short-cover-date

融券強制回補日是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/margin-short-cover-date 提供。

總覽

融券強制回補日——每列粒度:ticker / cover_date。

欄位型別說明
cover_datestring強制回補日(未來事件)
tickerstring
namestring
suspension_end_datestring停券結束日
reasonstring回補原因
marketstring

範例回應

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

{  "dataset_id": "margin_short_cover_date",  "request_context": {    "scope": "twse_margin_short_cover_date_only",    "coverage_type": "forward_snapshot_rolling_capture",    "filters": {      "cover_date": null,      "date_from": null,      "date_to": null,      "ticker": "2885",      "market": null,      "source_family": null,      "limit": 50    },    "min_cover_date": "2026-07-15",    "max_cover_date": "2026-08-12"  },  "quality": {    "row_count": 2,    "ticker_count": 1,    "sensitive_fields_exposed": false  },  "lineage": {    "source_families": [      "TWSE_BFI84U"    ],    "semantics": "cover_date = 停券起日 (officially labelled 最後回補日); source TWSE BFI84U 停資停券預告表"  },  "error": null,  "data": [    {      "cover_date": "2026-08-12",      "ticker": "2885",      "name": "元大金",      "suspension_end_date": "2026-08-17",      "reason": "除權",      "market": "TWSE",      "source_family": "TWSE_BFI84U",      "lineage": {        "source": "TWSE_BFI84U",        "endpoint": "exchangeReport/BFI84U",        "semantics": "停券起日=最後回補日"      }    },    {      "cover_date": "2026-07-15",      "ticker": "2885",      "name": "元大金",      "suspension_end_date": "2026-07-20",      "reason": "除息",      "market": "TWSE",      "source_family": "TWSE_BFI84U",      "lineage": {        "source": "TWSE_BFI84U",        "endpoint": "exchangeReport/BFI84U",        "semantics": "停券起日=最後回補日"      }    }  ],  "data_count": 2,  "known_gaps": [    "twse_only",    "forward_snapshot_no_dated_history",    "rolled_off_windows_not_re_verifiable"  ],  "warnings": [    "not_investment_advice"  ],  "envelope": {    "dataset_id": "margin_short_cover_date",    "scope": "twse_margin_short_cover_date_only",    "row_count": 2  }}

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

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

出處

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

source_familylineage

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

快速開始

  1. 把你的金鑰放進 X-API-Key 標頭。
  2. 加上查詢參數(symbol、日期區間、limit)。
  3. 送出請求並讀取 data 陣列。
curl "https://api.twmarketdata.com/v2/datasets/margin-short-cover-date?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數必填型別說明
symbolstring股票代碼,例如 2330。
start_datestring (YYYY-MM-DD)查詢起始日期。
end_datestring (YYYY-MM-DD)查詢結束日期。
limitinteger回傳筆數上限。

Python 範例

第一個呼叫:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/margin-short-cover-date",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])

帶日期區間篩選:

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/margin-short-cover-date",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]:    print(row)

OpenAPI

此端點為 GET /v2/datasets/margin-short-cover-date。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec

備註與限制

  • cover_date 是未來的強制回補日,不是你當時知道的時點。本表未帶公告日欄,故 as_of 無法成立;回測請改以官方公告日對齊,勿以 cover_date 當知識軸。max(cover_date) 落在未來,不可當新鮮度。