籌碼與資金

融資融券

提供 TWSE-only private beta 融資融券資料，適合用於籌碼風險監控與市場擁擠度觀察。

GET/v2/datasets/margin-short

Overview#

融資融券 API 目前以 TWSE-only private beta 方式提供，聚焦 official-first 的信用交易欄位。

文件必須保留 source_lineage、data_gaps 與 not_investment_advice，且不得把此資料說成 TPEx/full-market 或已啟用 daily write cron。

監控融資融券餘額變化。
建立信用交易風險濾網。
與法人買賣資料做交叉分析。

Request#

使用此 endpoint 時，symbol 為必要參數，並建議明確指定 market=TWSE。

Query Parameters#

欄位	型別	Required	說明
symbol	string	yes	股票代碼；beta 相容請求參數。
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": "margin_short",  "rows": [    {      "ticker": "0050",      "market": "TWSE",      "trade_date": "2026-05-28",      "margin_purchase_buy": 15234,      "margin_purchase_sell": 14820,      "margin_purchase_balance": 285004,      "short_sale_buy": 3120,      "short_sale_sell": 3388,      "short_sale_balance": 41882,      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn"      },      "data_gaps": [],      "not_investment_advice": true,      "legacy_aliases": {        "symbol": "0050"      }    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}

Field 說明#

欄位路徑	型別	說明
rows[].ticker	string	標的代碼。
rows[].market	string	市場別；目前網站僅宣稱 TWSE。
rows[].trade_date	string	交易日期（YYYY-MM-DD）。
rows[].margin_purchase_buy	number\|null	融資買進。
rows[].margin_purchase_sell	number\|null	融資賣出。
rows[].margin_purchase_balance	number\|null	融資餘額。
rows[].short_sale_buy	number\|null	融券買進（回補）。
rows[].short_sale_sell	number\|null	融券賣出。
rows[].short_sale_balance	number\|null	融券餘額。
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-28，總 rows 16,475、distinct tickers 1,272。
TWSE-only、private beta、no TPEx claim。
official-first 與 source_lineage/data_gaps 必須保留。
ratio tolerance 為 1e-6。
daily write cron not enabled。
若需法人淨買賣超補充資料，請搭配 `/v2/datasets/institutional-flow`。

Plan Requirement#

Private beta access
Developer
Pro
Enterprise

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

請求與回應

請求範例

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

狀態碼

成功回傳融資融券資料

JSON

{  "dataset": "margin_short",  "rows": [    {      "ticker": "0050",      "market": "TWSE",      "trade_date": "2026-05-28",      "margin_purchase_buy": 15234,      "margin_purchase_sell": 14820,      "margin_purchase_balance": 285004,      "short_sale_buy": 3120,      "short_sale_sell": 3388,      "short_sale_balance": 41882,      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn"      },      "data_gaps": [],      "not_investment_advice": true,      "legacy_aliases": {        "symbol": "0050"      }    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}

Overview#

融資融券 API 目前以 TWSE-only private beta 方式提供，聚焦 official-first 的信用交易欄位。

文件必須保留 source_lineage、data_gaps 與 not_investment_advice，且不得把此資料說成 TPEx/full-market 或已啟用 daily write cron。

監控融資融券餘額變化。

建立信用交易風險濾網。

與法人買賣資料做交叉分析。

欄位

型別

Required

說明

symbol

string

yes

股票代碼；beta 相容請求參數。

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": "margin_short",  "rows": [    {      "ticker": "0050",      "market": "TWSE",      "trade_date": "2026-05-28",      "margin_purchase_buy": 15234,      "margin_purchase_sell": 14820,      "margin_purchase_balance": 285004,      "short_sale_buy": 3120,      "short_sale_sell": 3388,      "short_sale_balance": 41882,      "source_provider": "twse_official",      "source_role": "official_twse_mi_margn",      "source_lineage": {        "provider": "twse_official",        "family": "official_twse_mi_margn"      },      "data_gaps": [],      "not_investment_advice": true,      "legacy_aliases": {        "symbol": "0050"      }    }  ],  "count": 1,  "meta": {    "plan": "pro",    "row_limit": 3,    "is_limited": false  }}

Field 說明#

欄位路徑	型別	說明
rows[].ticker	string	標的代碼。
rows[].market	string	市場別；目前網站僅宣稱 TWSE。
rows[].trade_date	string	交易日期（YYYY-MM-DD）。
rows[].margin_purchase_buy	number\|null	融資買進。
rows[].margin_purchase_sell	number\|null	融資賣出。
rows[].margin_purchase_balance	number\|null	融資餘額。
rows[].short_sale_buy	number\|null	融券買進（回補）。
rows[].short_sale_sell	number\|null	融券賣出。
rows[].short_sale_balance	number\|null	融券餘額。
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-28，總 rows 16,475、distinct tickers 1,272。

TWSE-only、private beta、no TPEx claim。

official-first 與 source_lineage/data_gaps 必須保留。

ratio tolerance 為 1e-6。

daily write cron not enabled。

若需法人淨買賣超補充資料，請搭配 `/v2/datasets/institutional-flow`。

{ "dataset": "margin_short", "rows": [ { "ticker": "0050", "market": "TWSE", "trade_date": "2026-05-28", "margin_purchase_buy": 15234, "margin_purchase_sell": 14820, "margin_purchase_balance": 285004, "short_sale_buy": 3120, "short_sale_sell": 3388, "short_sale_balance": 41882, "source_provider": "twse_official", "source_role": "official_twse_mi_margn", "source_lineage": { "provider": "twse_official", "family": "official_twse_mi_margn" }, "data_gaps": [], "not_investment_advice": true, "legacy_aliases": { "symbol": "0050" } } ], "count": 1, "meta": { "plan": "pro", "row_limit": 3, "is_limited": false }}