Building an AI agent? Start with /llms.txt for the full site index.

籌碼與資金

整體融資融券

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

This documentation page is currently available in Chinese only; English versions are coming soon.

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 已啟用。

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

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

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。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

Plan Requirement

Private beta access
Developer
Pro
Enterprise

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

請求與回應

Request example

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"

Status codes

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

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 已啟用。

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

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

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

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

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	回傳資料筆數。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.

Missing data is flagged honestly — we don't fill gaps with estimated values.

The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.

TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

{ "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 }}