AI agent?先讀 /llms.txt 取得全站索引。
籌碼與資金
信用交易系統統計:每筆為某市場某日之融資餘額總額、融券餘額總額、券資比、淨流與週轉強度。衍生自整體融資融券家族。非預測、非建議。
GET /v2/datasets/margin-system-stats即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。
| 欄位 | 型別 | 說明 |
|---|---|---|
margin_purchase_balance_total | TWD | |
short_sale_balance_total | shares | |
short_to_margin_balance_ratio | ratio | |
margin_net_flow | TWD | |
maintenance_ratio | ratio | NULL — not loaded (honest gap) |
9,936 列,2000-11-28 至 2026-07-09,按市場。maintenance_ratio 為 NULL——官方整體維持率未載入(maintenance_ratio_note 標示此誠實缺口);其餘欄由官方餘額計算。
此為本端點的真實回應。資料列位於 "data" 之下,來源資訊如下方所示;各資料集形狀不盡相同,請以本頁為準。
{ "dataset_id": "margin-system-stats", "row_count": 3, "data": [ { "market": "TWSE", "trade_date": "2026-07-09", "margin_purchase_balance_total": 9614955.0, "short_sale_balance_total": 203714.0, "short_to_margin_balance_ratio": 0.021187, "margin_net_flow": 30708.0, "maintenance_ratio": null }, { "market": "TWSE", "trade_date": "2026-07-08", "margin_purchase_balance_total": 9590605.0, "short_sale_balance_total": 205830.0, "short_to_margin_balance_ratio": 0.021462, "margin_net_flow": 66630.0, "maintenance_ratio": null }, { "market": "TWSE", "trade_date": "2026-07-07", "margin_purchase_balance_total": 9531735.0, "short_sale_balance_total": 213844.0, "short_to_margin_balance_ratio": 0.022435, "margin_net_flow": -122958.0, "maintenance_ratio": null } ]}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/margin-system-stats?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼,例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫:
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/margin-system-stats", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選:
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/margin-system-stats", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/margin-system-stats。完整機器可讀 schema(參數、認證、回應封裝)見 OpenAPI spec。