籌碼與資金
融資融券
提供融資融券資料，適合用於籌碼風險監控與市場擁擠度觀察。
GET
/v2/datasets/margin-shortOverview#
融資融券 API 提供台股融資與融券相關欄位，適合用於觀察籌碼壓力與交易擁擠度。
此頁為主公開 productized endpoint，回應固定為 dataset/rows/count + meta。
- 監控融資融券餘額變化。
- 建立籌碼風險濾網。
- 與法人買賣資料做交叉分析。
Request#
使用此 endpoint 時，symbol 為必要參數。
Query Parameters#
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| symbol | string | yes | 股票代碼（內部對應 ticker）。 |
| start_date | string | no | 查詢起始日期（YYYY-MM-DD）。 |
| end_date | string | no | 查詢結束日期（YYYY-MM-DD）。 |
| limit | integer | no | 回傳筆數（預設 100，最大 5000）。 |
Response Shape#
回應結構固定為 dataset、rows、count，並附 meta（plan/row_limit/is_limited）。
{
"dataset": "margin_short",
"rows": [
{
"symbol": "2330",
"date": "2026-04-22",
"flow_type": "all",
"margin_balance": 124500,
"margin_buy": 4200,
"margin_sell": 3800,
"short_balance": 18200,
"short_sell": 1600,
"short_cover": 1500,
"margin_short_ratio": 0.1462,
"source_role": "canonical",
"lineage": {
"source_dataset": "margin_trading_daily",
"source_tier": "primary"
},
"freshness": "2026-04-22"
}
],
"count": 1,
"meta": {
"plan": "free",
"row_limit": 50,
"is_limited": false
}
}Field 說明#
| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| rows[].symbol | string | 股票代碼。 |
| rows[].date | string | 交易日期（YYYY-MM-DD）。 |
| rows[].margin_balance | number|null | 融資餘額。 |
| rows[].margin_buy | number|null | 融資買進。 |
| rows[].margin_sell | number|null | 融資賣出。 |
| rows[].short_balance | number|null | 融券餘額。 |
| rows[].short_sell | number|null | 融券賣出。 |
| rows[].short_cover | number|null | 融券回補。 |
| rows[].margin_short_ratio | number|null | 融券/融資比率。 |
| rows[].source_role | string | 來源角色。 |
| rows[].lineage | object | 來源追溯資訊。 |
| rows[].freshness | string | 資料新鮮度日期。 |
| count | integer | 回傳資料筆數。 |
| meta.plan | string | 目前方案代碼。 |
| meta.row_limit | integer | 方案每次請求可回傳上限。 |
| meta.is_limited | boolean | 是否因方案限制而截斷資料。 |
Usage Notes / 使用建議#
- 本頁為主公開 route，已取代舊的 enhanced 泛用入口。
- 若需法人淨買賣超補充資料，請搭配 `/v2/datasets/institutional-flow`。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise