Taiwan Stock Margin Trading & Short Selling Balance (TWSE + TPEx)

Get structured JSON access to daily margin trading (融資) and short selling (融券) balances for every Taiwan-listed stock — both the main board (TWSE) and the OTC market (TPEx / 櫃買中心) in a single, normalized schema.

Margin data is Taiwan's classic retail sentiment indicator. Combined with our institutional flow Actors, you can see both sides of the market: what the pros are doing (TWSE / TPEx Institutional Trades) and what leveraged retail is doing (this Actor).

Why this data matters

• Margin balance (融資餘額) is the standard proxy for leveraged retail positioning — rising balances into a rally signal froth; forced margin calls accelerate sell-offs
• Short balance (融券餘額) feeds short-squeeze screens, especially around shareholder-meeting recall deadlines (股東會強制回補)
• Margin usage vs limit flags stocks approaching regulatory lending caps
• Day-over-day balance deltas are a widely used factor in Taiwan quant models

The data is public on the TWSE and TPEx websites but split across two sites with different formats and calendars. This Actor normalizes both into one clean JSON schema.

Output

One record per stock per trading day, 18 normalized fields. All quantities are in lots (張, 1 lot = 1,000 shares):

{
  "date": "2026-07-27",
  "market": "TWSE",
  "stock_code": "2330",
  "stock_name": "台積電",
  "margin_buy": 504,
  "margin_sell": 490,
  "margin_redemption": 23,
  "margin_balance_prev": 31915,
  "margin_balance": 31906,
  "margin_limit": 6483092,
  "short_sell": 2,
  "short_buy": 4,
  "short_redemption": 1,
  "short_balance_prev": 67,
  "short_balance": 64,
  "short_limit": 6483092,
  "offset": 5,
  "note": ""
}

Field	Meaning
margin_buy / margin_sell	融資買進 / 融資賣出 (new margin longs / margin longs closed)
margin_redemption	現金償還 (cash repayment)
margin_balance_prev / margin_balance	前日/今日融資餘額
margin_limit	次一營業日限額 (next-day regulatory cap)
short_sell / short_buy	融券賣出 / 融券買進 (new shorts / short covering)
short_redemption	現券償還 (share repayment)
short_balance_prev / short_balance	前日/今日融券餘額
offset	資券互抵 (same-day margin-short offset)

Balances always satisfy the accounting identity prev + buy - sell - redemption = balance (margin side) and prev + sell - buy - redemption = balance (short side) — the Actor validates this at parse time.

Input

Field	Type	Description
startDate	string (required)	YYYY-MM-DD
endDate	string	YYYY-MM-DD inclusive; empty = single day
market	string	both (default), twse, or tpex
stockCodes	array	Optional filter, e.g. ["2330", "5274"]. Empty = all (~2,200 stocks/day)

Example — one month of TSMC, Hon Hai and ASPEED margin data:

{
  "startDate": "2026-07-01",
  "endDate": "2026-07-27",
  "market": "both",
  "stockCodes": ["2330", "2317", "5274"]
}

Pricing & cost control

Pay per result: $0.50 / 1,000 records.

• Full market (TWSE + TPEx), one day: ~2,200 records ≈ $1.10
• Filtered to 5 tickers, one month: ~220 records ≈ $0.11

Use stockCodes to keep costs minimal when you only track a watchlist.

Data source & reliability

• Direct from TWSE's official MI_MARGN feed and TPEx's official margin balance feed — no third-party intermediaries
• Historical data available back to at least 2024 (both markets verified)
• Weekends skipped automatically; market holidays return no rows and are skipped
• Column-count and balance-identity guards: if either exchange changes its schema, the run fails loudly instead of returning silently corrupted data

Use cases

• Retail sentiment / leverage factor research on Taiwan equities
• Short-squeeze screeners (high short balance + shrinking margin limit)
• Margin-call risk dashboards for brokers and prop desks
• Financial newsletters and market-recap automation
• Academic research on leveraged retail behavior

Related Actors

• TWSE Institutional Trades — daily foreign/trust/dealer flows, main board
• TPEx Institutional Trades — same for the OTC market
• Taiwan Shareholding Dispersion (TDCC) — weekly retail vs whale ownership
• Taiwan Monthly Revenue — monthly revenue of all listed companies