Taiwan Short Sale & Securities Lending Balance (TWSE + TPEx)

Get structured JSON access to daily short interest for every Taiwan-listed stock — both short-selling mechanisms, both markets, one normalized schema.

Taiwan splits short selling across two separate systems, reported in separate places:

• 融券 (margin short sale) — retail-dominated, borrowed through the margin financing system, subject to mandatory recall before shareholder meetings
• 借券賣出 (SBL short sale) — the securities borrowing & lending system used by foreign institutions, hedge funds and market makers; typically 10–100× larger than margin shorts on liquid names

Looking at only one of them gives you a badly incomplete picture of bear positioning. This Actor pulls both, for the main board (TWSE) and the OTC market (TPEx / 櫃買中心), and adds the combined total.

Why this data matters

• Total short balance is the real short-interest number for a Taiwan stock — the margin-only figure most screeners use misses the institutional side entirely
• Short squeeze setups: margin shorts face forced covering around 停止過戶 (book-closure) dates; a high 融券餘額 into a shareholder meeting is a classic Taiwan squeeze catalyst
• Next-day SBL quota (30% of the trailing 30-day average volume) shows how much more institutions are allowed to short tomorrow — a hard ceiling on further pressure
• Suspension flags identify stocks where short selling is halted outright (停券 / 停止借券賣出), often a signal of prior squeeze intervention
• Day-over-day balance deltas are a standard factor in Taiwan quant models

This is the natural companion to margin long data — see Taiwan Margin Trading for the 融資 side.

Output

One record per stock per trading day, 24 normalized fields. All quantities are in shares (股), matching the exchange's own reporting for this report — note that the margin balance report publishes lots (張); 1 lot = 1,000 shares.

{
  "date": "2026-07-28",
  "market": "TWSE",
  "stock_code": "2330",
  "stock_name": "台積電",
  "short_balance_prev": 64000,
  "short_sell": 54000,
  "short_buy": 5000,
  "short_redemption": 0,
  "short_balance": 113000,
  "short_balance_change": 49000,
  "short_quota_next_day": 6483092516,
  "sbl_balance_prev": 13144514,
  "sbl_sell": 227000,
  "sbl_return": 90000,
  "sbl_adjustment": 0,
  "sbl_balance": 13281514,
  "sbl_balance_change": 137000,
  "sbl_quota_next_day": 11869217,
  "total_short_balance": 13394514,
  "total_short_balance_prev": 13208514,
  "total_short_balance_change": 186000,
  "note": "",
  "note_flags": []
}

Field	Meaning
short_sell / short_buy	融券賣出 / 融券買進 (new margin shorts / short covering)
short_redemption	現券償還 (share repayment)
short_balance_prev / short_balance	前日 / 今日融券餘額
short_balance_change	Day-over-day change in margin short balance
short_quota_next_day	次一營業日限額 — regulatory cap (25% of free float)
sbl_sell / sbl_return	借券賣出當日賣出 / 當日還券
sbl_adjustment	當日調整 (position transfers between trading categories, error corrections)
sbl_balance_prev / sbl_balance	前日 / 當日借券賣出餘額
sbl_balance_change	Day-over-day change in SBL short balance
sbl_quota_next_day	次一營業日可借券賣出限額 — 30% of the trailing 30-day average volume
total_short_balance	short_balance + sbl_balance — combined bear positioning
note / note_flags	Raw exchange flags and their decoded meanings

note_flags decodes the exchange's single-letter codes: X 停券, Y 未取得信用交易資格, V 停止借券賣出, % 信用額度分配, Z 借券賣出已達總量控管, ! 停止買賣.

Both balances satisfy the accounting identities the exchange prints on the report itself:

• 融券: prev + sell - buy - redemption = balance
• 借券賣出: prev + sell - return + adjustment = balance

The Actor checks both at parse time and logs any violation loudly.

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)
minTotalShortBalance	integer	Only return stocks with combined short balance ≥ this many shares. 0 = no filter

Example — one month of short interest for three tickers:

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

Example — daily screen for meaningfully shorted stocks only:

{
  "startDate": "2026-07-28",
  "market": "both",
  "minTotalShortBalance": 1000000
}

Pricing & cost control

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

• Full market (TWSE + TPEx), one day: ~2,220 records ≈ $1.11
• Filtered to 5 tickers, one month: ~200 records ≈ $0.10
• minTotalShortBalance: 1000000, one day: a few hundred records

Most Taiwan stocks carry little or no short interest, so minTotalShortBalance is usually the cheapest way to run a market-wide screen.

Data source & reliability

• Direct from the official TWSE (TWT93U) and TPEx 信用額度總量管制餘額表 feeds — no third-party intermediaries
• Historical data verified back to at least 2024 for both markets
• Weekends skipped automatically; market holidays return no rows and are skipped
• Column-layout guard: if either exchange changes its schema, the run fails loudly instead of returning silently mis-mapped numbers
• Values cross-verified against two independent official feeds (MI_MARGN for the margin short side, openapi.twse.com.tw/v1/SBL/TWT96U for next-day SBL quotas)
• The exchanges refresh this report twice each evening (~20:30 and ~22:30 Taipei time); run after 22:30 for the settled figures

Use cases

• Short-squeeze screeners — high margin short balance heading into book-closure dates
• True short-interest ratios for Taiwan equities (margin + SBL, not margin alone)
• Tracking foreign institutional bear positioning via the SBL side
• Risk dashboards flagging stocks near their SBL quota ceiling or under a short-selling suspension
• Academic and quant research on short-selling constraints in an emerging market

Related Actors

• Taiwan Margin Trading — the 融資 long side, same markets and date range
• 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