籌碼與資金

整體融資融券

提供 TWSE-only private beta 總體融資融券彙總資料，適合用於市場風險背景觀測。

GET/v2/datasets/total-margin-short

Overview#

整體融資融券 API 以 TWSE-only private beta 方式提供，回報市場總體 credit aggregate 欄位。

文件保留 source_lineage、data_gaps 與 not_investment_advice，不得誤述為 TPEx/full-market 或 daily write cron 已啟用。

觀察市場總量融資/融券買賣趨勢。
配合籌碼面指標做風險情境判讀。
對接私域研究流程時保留缺口欄位。

Query Parameters#

欄位	型別	Required	說明
market	string	no	建議指定 TWSE；本頁面不宣稱 TPEx 支援。
start_date	string	no	查詢起始日期（YYYY-MM-DD）。
end_date	string	no	查詢結束日期（YYYY-MM-DD）。
limit	integer	no	回傳筆數。

Response Shape#

回應固定為 dataset、rows、count，加上 meta；欄位需保留 source_lineage、data_gaps 與 not_investment_advice。

{  "dataset": "total_margin_short",  "rows": [    {      "market": "TWSE",      "trade_date": "2026-05-14",      "margin_purchase_balance_total": 1234567,      "short_sale_balance_total": 78901,      "margin_purchase_buy_total": 3210,      "margin_purchase_sell_total": 2880,      "short_sale_buy_total": 420,      "short_sale_sell_total": 390,      "margin_purchase_amount_total": 6543210,      "currency": "TWD",      "market_scope": "TWSE",      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn_summary",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn_summary"      },      "data_gaps": [],      "not_investment_advice": true    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}

Field 說明#

欄位路徑	型別	說明
rows[].market	string	市場別；目前網站僅公開 TWSE。
rows[].trade_date	string	交易日期（YYYY-MM-DD）。
rows[].margin_purchase_balance_total	number\|null	融資餘額總額。
rows[].short_sale_balance_total	number\|null	融券餘額總額。
rows[].margin_purchase_buy_total	number\|null	融資買入總額。
rows[].margin_purchase_sell_total	number\|null	融資賣出總額。
rows[].short_sale_buy_total	number\|null	融券買進（回補）總額。
rows[].short_sale_sell_total	number\|null	融券賣出總額。
rows[].margin_purchase_amount_total	number\|null	融資交易總金額。
rows[].currency	string	幣別（如 TWD）。
rows[].market_scope	string	市場範圍；本 dataset 限 TWSE。
rows[].source_provider	string	來源提供者。
rows[].source_role	string	來源角色。
rows[].source_lineage	object	資料來源血緣；必須保留並於文案中說明。
rows[].data_gaps	array	資料缺口訊號。
rows[].not_investment_advice	boolean	非投資建議宣告。
count	integer	回傳資料筆數。

Usage Notes / 使用建議#

目前 coverage 種子為 2026-03-10..2026-05-14，row_count=3（private beta seeded）。
TWSE-only、seed scope，且 no TPEx claim。
official-first 與 source_lineage/data_gaps 必須保留。
ratio tolerance 為 1e-6。
daily write cron not enabled。

Plan Requirement#

Private beta access
Developer
Pro
Enterprise

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/total-margin-short?market=TWSE&start_date=2026-03-10&end_date=2026-05-14&limit=3" \  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳整體融資融券資料

JSON

{  "dataset": "total_margin_short",  "rows": [    {      "market": "TWSE",      "trade_date": "2026-05-14",      "margin_purchase_balance_total": 1234567,      "short_sale_balance_total": 78901,      "margin_purchase_buy_total": 3210,      "margin_purchase_sell_total": 2880,      "short_sale_buy_total": 420,      "short_sale_sell_total": 390,      "margin_purchase_amount_total": 6543210,      "currency": "TWD",      "market_scope": "TWSE",      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn_summary",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn_summary"      },      "data_gaps": [],      "not_investment_advice": true    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}

Overview#

整體融資融券 API 以 TWSE-only private beta 方式提供，回報市場總體 credit aggregate 欄位。

文件保留 source_lineage、data_gaps 與 not_investment_advice，不得誤述為 TPEx/full-market 或 daily write cron 已啟用。

觀察市場總量融資/融券買賣趨勢。

配合籌碼面指標做風險情境判讀。

對接私域研究流程時保留缺口欄位。

欄位

型別

Required

說明

market

string

建議指定 TWSE；本頁面不宣稱 TPEx 支援。

start_date

string

查詢起始日期（YYYY-MM-DD）。

end_date

string

查詢結束日期（YYYY-MM-DD）。

limit

integer

回傳筆數。

Response Shape#

回應固定為 dataset、rows、count，加上 meta；欄位需保留 source_lineage、data_gaps 與 not_investment_advice。

{  "dataset": "total_margin_short",  "rows": [    {      "market": "TWSE",      "trade_date": "2026-05-14",      "margin_purchase_balance_total": 1234567,      "short_sale_balance_total": 78901,      "margin_purchase_buy_total": 3210,      "margin_purchase_sell_total": 2880,      "short_sale_buy_total": 420,      "short_sale_sell_total": 390,      "margin_purchase_amount_total": 6543210,      "currency": "TWD",      "market_scope": "TWSE",      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn_summary",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn_summary"      },      "data_gaps": [],      "not_investment_advice": true    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}

Field 說明#

欄位路徑	型別	說明
rows[].market	string	市場別；目前網站僅公開 TWSE。
rows[].trade_date	string	交易日期（YYYY-MM-DD）。
rows[].margin_purchase_balance_total	number\|null	融資餘額總額。
rows[].short_sale_balance_total	number\|null	融券餘額總額。
rows[].margin_purchase_buy_total	number\|null	融資買入總額。
rows[].margin_purchase_sell_total	number\|null	融資賣出總額。
rows[].short_sale_buy_total	number\|null	融券買進（回補）總額。
rows[].short_sale_sell_total	number\|null	融券賣出總額。
rows[].margin_purchase_amount_total	number\|null	融資交易總金額。
rows[].currency	string	幣別（如 TWD）。
rows[].market_scope	string	市場範圍；本 dataset 限 TWSE。
rows[].source_provider	string	來源提供者。
rows[].source_role	string	來源角色。
rows[].source_lineage	object	資料來源血緣；必須保留並於文案中說明。
rows[].data_gaps	array	資料缺口訊號。
rows[].not_investment_advice	boolean	非投資建議宣告。
count	integer	回傳資料筆數。

{ "dataset": "total_margin_short", "rows": [ { "market": "TWSE", "trade_date": "2026-05-14", "margin_purchase_balance_total": 1234567, "short_sale_balance_total": 78901, "margin_purchase_buy_total": 3210, "margin_purchase_sell_total": 2880, "short_sale_buy_total": 420, "short_sale_sell_total": 390, "margin_purchase_amount_total": 6543210, "currency": "TWD", "market_scope": "TWSE", "source_provider": "twse_official", "source_role": "official_twse_mi_margn_summary", "source_lineage": { "provider": "twse_official", "family": "official_twse_mi_margn_summary" }, "data_gaps": [], "not_investment_advice": true } ], "count": 1, "meta": { "plan": "pro", "row_limit": 3, "is_limited": false }}

整體融資融券

Overview#

Request#

Query Parameters#

Response Shape#

Field 說明#

Usage Notes / 使用建議#

Plan Requirement#

整體融資融券

Overview#

Request#

Query Parameters#

Response Shape#

Field 說明#

Usage Notes / 使用建議#

Plan Requirement#