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

---

Taiwan Market Data Suite

This Actor is part of a suite of 23 Taiwan market data APIs by chamarix — official sources only, cross-validated against independent official endpoints, clean JSON out. Code samples for the whole suite: GitHub.

Market data:

• twse-institutional-trades — Daily institutional buy/sell (foreign, investment trust, dealer) per stock — TWSE listed
• tpex-institutional-trades — Daily institutional buy/sell per stock — TPEx OTC market
• taiwan-monthly-revenue — Monthly revenue of 1,900+ listed & OTC companies, MoM/YoY
• taiwan-financial-statements — Quarterly income statement, balance sheet & cash flow back to 2013
• taiwan-dividend-calendar — Ex-dividend / ex-rights dates, reference prices & payouts back to 2003
• taiwan-margin-trading — Daily margin trading & short sale balances per stock
• taiwan-sbl-short-sale-balance — Securities-lending short sale balances per stock
• taiwan-day-trading-stats — Day-trading volume, value & ratio per stock since 2014
• tdcc-shareholding-dispersion — Weekly TDCC shareholding dispersion (retail vs whale structure)
• taiwan-foreign-shareholding — Foreign ownership percentage & remaining quota per stock
• taifex-institutional-derivatives — Institutional futures & options positions (TAIFEX), incl. put/call ratio
• taiwan-warrants-daily — Daily quotes, strike, expiry & moneyness for every listed/OTC warrant since 2004
• taiwan-stock-alerts — Watch-list, disposition & short-sale suspension alerts
• taiwan-insider-share-transfers — Insider share-transfer filings (directors, officers, 10% holders) since 2002
• taiwan-director-shareholdings — Monthly director/officer shareholdings & share-pledge ratio since 1999
• taiwan-block-trades — Every block trade (鉅額交易) with price, size & basket constituents since 2005
• taiwan-shareholder-meetings — Shareholder meeting dates, book closure periods & e-voting since 2005
• taiwan-emerging-stock-quotes — Emerging (興櫃) board quotes, pre-IPO register & history since 2003
• taiwan-etf-regular-investment — Monthly regular savings plan (定期定額) rankings for stocks & ETFs since 2020
• taiwan-treasury-stock-buybacks — Every treasury-stock buyback (庫藏股) filing, plan vs execution, since 2000

Property market:

• taiwan-real-estate-transactions — Actual registered sale, presale & lease prices (實價登錄) for all 22 cities since 2012

Government & civic data:

• taiwan-legislator-monitor — Legislative Yuan bills, legislators & meetings
• taiwan-tender-monitor — Government e-procurement tenders (open calls, awards, failures)