EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

籌碼與資金

整體融資融券匯總

Name: Total margin & short
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

全市場每交易日融資與融券總餘額，來源為官方 TWSE 信用交易報表。

← 整體融資融券匯總資料集總覽

參考來源: TWSE·方案: starter·計費: 2 點·GET /v2/datasets/total-margin-short

整體融資融券匯總是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/total-margin-short 提供。

總覽

total-margin-short 以官方 TWSE 信用交易報表為源，每交易日回傳一列全市場資料，含全體上市股票的融資與融券總餘額；每列附來源角色，總額可追溯。此端點為預覽面——目前涵蓋為部分資料，以快照形式提供，尚非完整回補的歷史。

欄位	型別	說明
`market`	string
`trade_date`	string
`margin_purchase_balance_total`	number
`short_sale_balance_total`	number
`margin_purchase_buy_total`	number
`margin_purchase_sell_total`	number
`short_sale_buy_total`	number
`short_sale_sell_total`	number
`margin_purchase_amount_total`	null
`currency`	string
`market_scope`	string

涵蓋範圍

列數	9,971
涵蓋起訖	2000-11-28 – 2026-09-02
分級	參考
量測時間	2026-09-03取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "rows" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "dataset": "total_margin_short",
  "dataset_id": "total_margin_short",
  "rows": [
    {
      "market": "TWSE",
      "trade_date": "2026-08-03",
      "margin_purchase_balance_total": 9120700,
      "short_sale_balance_total": 185322,
      "margin_purchase_buy_total": 490794,
      "margin_purchase_sell_total": 510139,
      "short_sale_buy_total": 35122,
      "short_sale_sell_total": 32051,
      "margin_purchase_amount_total": null,
      "currency": "TWD",
      "market_scope": "TWSE",
      "source_provider": "derived_twmd",
      "source_role": "derived_market_total_from_margin_short_enhanced",
      "source_lineage": {
        "emitter": "build_margin_short_total_candidates",
        "derivation": "sum per-ticker margin_short_enhanced by (market,trade_date)",
        "verified_vs": "total_margin_short_daily_items official overlap (n6, 1551/1551)"
      },
      "data_gaps": [
        "margin_purchase_amount_total=金額不在逐檔源→NULL"
      ],
      "not_investment_advice": true
    }
  ],
  "count": 1,
  "plan_id": "enterprise",
  "meta": {
    "plan": "enterprise",
    "row_limit": 100000,
    "market": "TWSE",
    "start_date": "2026-08-03",
    "end_date": "2026-08-03",
    "private_beta_contract": true,
    "twse_only_scope": true,
    "is_limited": false
  }
}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

source_providersource_rolesource_lineagedata_gapsnot_investment_advice

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 整體融資融券匯總 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/capital-flows/total-margin-short

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

鉅額交易日資料
可用 market + trade_date 對齊
外資持股比率
可用 market + trade_date 對齊
三大法人買賣
可用 market + trade_date 對齊
借券使用率
可用 market + trade_date 對齊
融資融券
可用 market + trade_date 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 rows 陣列。

curl "https://api.twmarketdata.com/v2/datasets/total-margin-short?start_date=2026-08-03&end_date=2026-08-03" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	是	string	股票代碼，例如 2330。
`start_date`	否	string (YYYY-MM-DD)	查詢起始日期。
`end_date`	否	string (YYYY-MM-DD)	查詢結束日期。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/total-margin-short",
    params={},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["rows"])

OpenAPI

此端點為 GET /v2/datasets/total-margin-short。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

預覽等級：涵蓋為部分且以快照提供，非完整回補的每日歷史——請勿假設每個交易日皆存在。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/total-margin-short?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset": "total_margin_short",
  "dataset_id": "total_margin_short",
  "rows": [
    {
      "market": "<string>",
      "trade_date": "<string>",
      "margin_purchase_balance_total": "<number>",
      "short_sale_balance_total": "<number>",
      "margin_purchase_buy_total": "<number>",
      "margin_purchase_sell_total": "<number>",
      "short_sale_buy_total": "<number>",
      "short_sale_sell_total": "<number>",
      "margin_purchase_amount_total": "<null>",
      "currency": "<string>",
      "market_scope": "<string>",
      "source_provider": "<string>",
      "source_role": "<string>",
      "source_lineage": {
        "emitter": "<string>",
        "derivation": "<string>",
        "verified_vs": "<string>"
      },
      "data_gaps": "<array>",
      "not_investment_advice": "<boolean>"
    }
  ],
  "count": 1,
  "plan_id": "enterprise",
  "meta": {
    "plan": "<string>",
    "row_limit": "<number>",
    "market": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "private_beta_contract": "<boolean>",
    "twse_only_scope": "<boolean>",
    "is_limited": "<boolean>"
  }
}