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/margin-short

Overview

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

文件必須保留 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.

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；實際覆蓋筆數與涵蓋股票數詳見 /datasets。
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`。

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/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"

Status codes

成功回傳融資融券資料

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。

監控融資融券餘額變化。

建立信用交易風險濾網。

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

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

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；實際覆蓋筆數與涵蓋股票數詳見 /datasets。

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`。

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