AI agent?先讀 /llms.txt 取得全站索引。
籌碼與資金
每檔上市股票每日融資與融券餘額,來源為官方 TWSE 信用交易報表。
GET /v2/datasets/margin-short融資融券是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/margin-short 提供。
margin-short 以官方 TWSE 信用交易報表為源,每交易日每檔股票回傳一列,含融資與融券餘額;每列附來源角色,餘額可回溯官方報表。此端點為預覽面——目前涵蓋為部分資料,以快照形式提供,尚非完整回補的歷史。
| 欄位 | 型別 | 說明 |
|---|---|---|
ticker | string | |
market | string | |
trade_date | string | |
margin_purchase_buy | number | |
margin_purchase_sell | number | |
margin_purchase_balance | number | |
short_sale_buy | number | |
short_sale_sell | number | |
short_sale_balance | number | |
symbol | string | 股票代碼。 |
as_of_date | string | |
margin_balance | number | 融資餘額(股)。 |
short_balance | number | 融券餘額(股)。 |
margin_purchase | number | |
short_sale | number | |
margin_utilization_ratio | number |
| 列數 | 約 7,825,703 |
| 涵蓋起訖 | 2000-11-28 – 2026-09-02 |
| 分級 | 參考 |
| 量測時間 | 2026-09-03取自資料集登錄表 |
此為本端點的真實回應。資料列位於 "rows" 之下,來源資訊如下方所示;各資料集形狀不盡相同,請以本頁為準。
{
"dataset": "margin_short",
"dataset_id": "margin_short",
"rows": [
{
"ticker": "1101",
"market": "TWSE",
"trade_date": "2026-08-05",
"margin_purchase_buy": 413,
"margin_purchase_sell": 766,
"margin_purchase_balance": 33953,
"short_sale_buy": 2,
"short_sale_sell": 2,
"short_sale_balance": 25,
"data_gaps": [],
"source_provider": "twse_official",
"source_role": "official_twse_mi_margn",
"source_lineage": {
"endpoint": "https://www.twse.com.tw/exchangeReport/MI_MARGN",
"parsed_by": "position",
"source_url": "https://www.twse.com.tw/exchangeReport/MI_MARGN?response=json&date=20260805&selectType=ALL",
"source_role": "official_twse_mi_margn",
"source_title": "115年08月05日 融資融券彙總 (全部)",
"source_family": "twse_margin_short_balance",
"request_params": {
"date": "20260805",
"response": "json",
"selectType": "ALL"
},
"source_provider": "twse_official"
},
"not_investment_advice": true,
"symbol": "1101",
"as_of_date": "2026-08-05",
"margin_balance": 33953,
"short_balance": 25,
"margin_purchase": 413,
"short_sale": 2,
"margin_utilization_ratio": 0.0007363119606514888
},
{
"ticker": "1101",
"market": "TWSE",
"trade_date": "2026-08-04",
"margin_purchase_buy": 1390,
"margin_purchase_sell": 228,
"margin_purchase_balance": 34389,
"short_sale_buy": 31,
"short_sale_sell": 2,
"short_sale_balance": 25,
"data_gaps": [],
"source_provider": "twse_official",
"source_role": "official_twse_mi_margn",
"source_lineage": {
"endpoint": "https://www.twse.com.tw/exchangeReport/MI_MARGN",
"parsed_by": "position",
"source_url": "https://www.twse.com.tw/exchangeReport/MI_MARGN?response=json&date=20260804&selectType=ALL",
"source_role": "official_twse_mi_margn",
"source_title": "115年08月04日 融資融券彙總 (全部)",
"source_family": "twse_margin_short_balance",
"request_params": {
"date": "20260804",
"response": "json",
"selectType": "ALL"
},
"source_provider": "twse_official"
},
"not_investment_advice": true,
"symbol": "1101",
"as_of_date": "2026-08-04",
"margin_balance": 34389,
"short_balance": 25,
"margin_purchase": 1390,
"short_sale": 2,
"margin_utilization_ratio": 0.0007269766495100178
}
],
"count": 50,
"plan_id": "enterprise",
"meta": {
"plan": "enterprise",
"row_limit": 100000,
"market": "TWSE",
"private_beta_contract": true,
"is_limited": false
}
}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值;英文頁會以標記取代,以維持全英文。
以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。
data_gapssource_providersource_rolesource_lineagenot_investment_advice本服務部分資料取自政府資料開放平臺(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/capital-flows/margin-short
版本取自資料集自己的 as_of,不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位,不會補一個看起來合理的值。 驗證簽章
可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。
curl "https://api.twmarketdata.com/v2/datasets/margin-short?symbol=1101" \
-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/margin-short",
params={"symbol": "1101"},
headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["rows"])此端點為 GET /v2/datasets/margin-short。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。