AI agent？先讀 /llms.txt 取得全站索引。
籌碼與資金
增強融資融券，在官方 TWSE 信用交易數字之上預先計算使用率與日變動。
GET /v2/datasets/margin-short-enhancedmargin-short-enhanced 為推導型資料集：以官方 TWSE 融資與融券餘額為基礎，附上原本需自行計算的使用率與日變動。lineage 欄位回指底層信用交易報表，基準餘額可稽核。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | 股票代碼。 |
date | string | 交易日。 |
margin_balance | number | 融資餘額（股）。 |
margin_utilization | number | 融資餘額占融資限額比率（0-1）。 |
margin_change | number | 融資餘額日變動（股）。 |
short_margin_ratio | number | 券資比（融券餘額占融資餘額比值）。 |
source_role | string | 正規來源角色（derived_twse_margin_enhanced）。 |
| 列數 | 7,798,493 |
| 涵蓋起訖 | 2000-11-28 至 2026-07-09 |
| 分級 | 衍生 |
此為本端點的真實回應。資料列位於 "envelope.data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "api_version": "v2", "endpoint": "/v2/datasets/margin-short-enhanced", "request_id": "req_36b76b1d40b7", "plan_id": "enterprise", "dataset": "margin_short", "query": { "ticker": "2330", "date_from": null, "date_to": null, "limit": 50, "offset": 0, "sort_by": "trade_date", "sort_order": "desc" }, "meta": { "rows_returned": 50, "mandatory_contract_fields_present": [ "api_version", "data", "data_as_of" ], "plan": "enterprise", "row_limit": 100000, "is_limited": false }, "envelope": { "api_version": "v2", "dataset": "margin_short", "dataset_version": "v2.0.0-preview", "release_version": "v2.2026-07-09.preview", "release_date": "2026-07-09", "data_as_of": "2026-07-09", "request_context": { "ticker": "2330", "as_of_date": "2026-07-09", "family": "chip_deep", "field_group_type": "derived", "dataset_view": "margin_short_enhanced_v1", "supported_sort_by": [ "trade_date" ], "supported_filter_fields": [ "ticker", "date_from", "date_to" ] }, "data": [ { "ticker": "2330", "market": "TWSE", "trade_date": "2026-07-09", "margin_balance": 33061, "short_balance": 71, "margin_balance_change": 778, "short_balance_change": -14, "margin_usage_ratio": 0.997857, "short_usage_ratio": 0.002143, "margin_buy": 1064, "margin_sell": 272, "short_sell": 14, "short_cover": 0, "securities_lending_balance": null, "securities_lending_change": null, "provider": "twse_official", "source_role": "official_twse_mi_margn", "lineage": { "feeds": [ "margin_trading_daily", "short_selling_daily" ], "merged_from": "margin_short_daily", "transformation_version": "margin_short_deep_merge_v1" }, "data_gaps": [], "updated_at": "2026-07-14T14:03:17.715986" }, { "ticker": "2330", "market": "TWSE", "trade_date": "2026-07-08", "margin_balance": 32283, "short_balance": 85, "margin_balance_change": -259, "short_balance_change": -4, "margin_usage_ratio": 0.997374, "short_usage_ratio": 0.002626, "margin_buy": 807, "margin_sell": 829, "short_sell": 8, "short_cover": 4, "securities_lending_balance": null, "securities_lending_change": null, "provider": "twse_official", "source_role": "official_twse_mi_margn", "lineage": { "feeds": [ "margin_trading_daily", "short_selling_daily" ], "merged_from": "margin_short_daily", "transformation_version": "margin_short_deep_merge_v1" }, "data_gaps": [], "updated_at": "2026-07-14T14:03:17.715986" } ], "quality": { "freshness_state": "fresh", "freshness_as_of": "2026-07-09", "completeness_ratio": 1, "quality_status": "ready" }, "lineage": { "source_role": "canonical", "selected_source": "twse_official", "fallback_chain": [ "tpex_official", "data_gov_mirror" ], "policy_notes": [ "official/public-first canonical", "margin_short enhanced product rows derived from chip_deep margin/short/lending canonical payloads", "unstable fields excluded from public contract (scores/signals/custom factors)" ] }, "error": { "error_code": null, "error_message": null, "dataset": "margin_short", "request_id": "read-api-d78cfcbeec22", "blocking_gate": null } }}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/margin-short-enhanced?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-short-enhanced", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["envelope"]["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-short-enhanced", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["envelope"]["data"]: print(row)此端點為 GET /v2/datasets/margin-short-enhanced。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。