Taiwan Short Sale Eligibility & Stock Borrow Fee API (可否放空・可借券股數・借券費率・強制回補日)

Can this Taiwan stock be shorted today, how many shares can be borrowed, what does borrowing cost, and when must existing shorts be covered? One dataset answering all four for every TWSE-listed and TPEx OTC stock, built from ten official exchange reports and checked against each other.

Most short-interest data tells you how much of a stock has already been shorted. None of it tells you whether you are allowed to short it this morning — and in Taiwan that is a real question. Short selling below the last close is permitted only for stocks on a daily list; the list suspends names ahead of every dividend, shareholder meeting and capital change; the exchange cuts margin and raises short margin on stocks it considers overheated; and the shares available to borrow are rationed by a published daily quota. This Actor returns all of it, per stock, in one run.

Output

Six record types in one dataset, told apart by record_type. Real rows:

eligibility — may it be shorted below the last close today? (TWT92U / TPEx 平盤下得融(借)券賣出之證券名單)

{
  "record_type": "eligibility",
  "market": "TWSE",
  "date": "2026-09-30",
  "stock_code": "00406A",
  "stock_name": "主動中信台灣收益",
  "margin_short_suspended": true,
  "sbl_short_suspended": false,
  "below_close_short_banned": false,
  "below_close_ban_rule": "previous_close_limit_down",
  "any_restriction": true
}

shortable_shares — shares available to borrow and sell short today (TWT96U, both markets)

{
  "record_type": "shortable_shares",
  "market": "TWSE",
  "as_of_date": "2026-09-30",
  "retrieved_at": "2026-09-30",
  "stock_code": "2330",
  "shortable_shares": 6250884,
  "matches_previous_session_quota": true
}

borrow_fee — the rate paid to borrow a stock (BFIF8U / TPEx 券差借券費率)

{
  "record_type": "borrow_fee",
  "market": "TWSE",
  "date": "2026-09-29",
  "stock_code": "2030",
  "stock_name": "彰源",
  "borrowed_shares": 1000,
  "borrow_fee_rate_pct": 3.5,
  "lot_in_day": 1
}

suspension_notice — upcoming short-sale suspensions and the forced cover date (BFI84U / TPEx 暫停融券賣出預告表)

{
  "record_type": "suspension_notice",
  "market": "TWSE",
  "as_of_date": "2026-09-29",
  "stock_code": "00400A",
  "stock_name": "主動國泰動能高息",
  "forced_cover_date": "2026-10-02",
  "suspension_end_date": "2026-10-07",
  "reason": "分配收益"
}

margin_adjustment — margin loan cuts and short margin raises, with reasons (BFIB9U / TPEx 調整成數)

{
  "record_type": "margin_adjustment",
  "market": "TWSE",
  "date": "2026-09-29",
  "stock_code": "2455",
  "stock_name": "全新",
  "margin_ratio_cut_tenths": 6,
  "short_margin_raise_tenths": 2,
  "in_effect": true,
  "reasons": [
    {"reason": "股價波動過度劇烈", "start_date": "2026-09-02", "restore_date": null},
    {"reason": "監視第二次處置", "start_date": "2026-09-23", "restore_date": "2026-10-06"}
  ],
  "cumulative_matches_rule": true
}

collateral_balance (opt-in) — shares pledged as collateral under five kinds of loan, per stock per day (TWTA1U, both markets): margin, broker securities-business loans, broker and finance-company unrestricted-purpose loans, and settlement financing, each with previous balance, new, sold, repaid, swapped, balance and next-day limit, in shares.

A default daily run returns about 4,700 rows: ~2,070 eligibility, ~2,090 shortable-share, ~100 borrow-fee, ~400 margin-adjustment and ~40 suspension rows. Turn on onlyRestricted to keep just the restricted names.

History: which reports have it and which do not

This matters more than anything else about this data. Four of these reports accept a date parameter and ignore it — ask for 2020 and they return this morning's list with a normal "OK" status. A scraper that trusts the parameter produces a decade of plausible, entirely fake history. Every report here was checked by hashing its whole payload on dates years apart.

Record type	History	How
eligibility	2013-09-23 → both markets	one request per session
borrow_fee	2015-05 → both markets	one request per month
margin_adjustment	TWSE 2014-04-18 →; TPEx today only	TWSE takes startDate/endDate, not date
collateral_balance	2006-10-02 → both markets	one request per session
shortable_shares	today only	see below
suspension_notice	today only	forward-looking by nature

Snapshot rows carry retrieved_at and the date the report itself names (as_of_date) instead of a session date, and in a history run they are only included when the range reaches today — a request for 2020 never comes back holding today's list.

Shortable shares do have a history, just not in this report. Today's shortable_shares equals the 次一營業日可借券賣出限額 published after the previous session — 2,090 of 2,090 stocks on 2026-09-30 — and that figure is dated and goes back years. It is sbl_quota_next_day in the sister Actor taiwan-sbl-short-sale-balance. This Actor re-checks the equality on every run and records it on each row.

The TWSE margin-adjustment report was catalogued as snapshot-only too, because it ignores date=. It answers startDate/endDate properly back to 2014-04-18, which is what the page's own form sends.

Verification

• Margin adjustments are rebuilt from their parts. The TWSE report prints each stock as a block of reasons plus a 累計 (cumulative) row, and its footnote gives the rule: the three ordinary reasons share a single one-tenth step, a second-stage surveillance disposition cuts the margin loan ratio by six tenths, steps add, and the loan cut stops at six tenths. The rule is re-applied to every block and must reproduce the printed total exactly. It held for 559 of 559 blocks across ten dates from 2014 to 2026; a miss fails the run.
• Collateral balances satisfy the report's own identity — 今日餘額 = 前日餘額 + 新增 − 賣出 − 現償 − 更換 — on every block of every row. The report prints thousands of shares and rounds each figure separately, so the tolerance is the sum of their half-units (2 with five terms, 3 with six), derived rather than picked. Across four dates from 2006 to 2026, two ETF rows in 2015 were off by one thousand shares; everything else was exact. The margin block also equals the separate margin-trading report (MI_MARGN) — 1,294 of 1,294 stocks on 2026-09-29.
• Shortable shares equal the previous session's published quota from a separate report, and equal the exchange's open-data copy of the same table (2,090 of 2,090).
• Suspension notices agree with the eligibility list. Every stock whose notice window covers a session is flagged 暫停融券賣出 on that session's list — 21 of 21 on 2026-09-30, both markets. The TWSE notice table also matches its open-data copy row for row.

Traps in the source that this Actor handles

• The shortable-shares table is two tables side by side. Its header literally reads 證券代號, 可借券賣出股數, 證券代號, 可借券賣出股數 — listed stocks on the left, OTC on the right. Reading it by column name keeps only the right-hand stock and silently drops half the market. Each code is also wrapped in an HTML link.
• The below-close ban rule changes. The fifth column's header names the rule: on most dates it is "previous close was limit-down", but TPEx prints "previous close fell 3.5% or more" on some dates (seen on 2020-03-20 and 2023-01-03). The header is read on every payload and published as below_close_ban_rule; an unknown header stops the run.
• Borrow fees are not capped at 7%. Nearly every month tops out at exactly 7.000%, which looks like a ceiling; TWSE printed 57.143% for 2390 on 2020-06-17. The rate is published as-is. TPEx also prints 0.000% lots.
• The fee reports are monthly and list each borrowed lot separately, so one stock can have several rows on a day at different rates (lot_in_day numbers them). Days on which nobody failed to deliver are printed as a row of dashes; those are dropped.
• Holidays look different on each exchange. TWSE answers "OK" with no rows; TPEx's list answers with a single one-cell row holding the date. Both are treated as a closed market, not as data.
• Codes are not always four digits (00400A, 00631L, 006201).

Input

• recordTypes — any of the six. collateral_balance is off by default.
• startDate / endDate — leave both empty for the latest of everything (each report's most recent session, looking back over holidays). Fill them in for history.
• market — both, twse or tpex.
• stockCodes — keep only these.
• onlyRestricted — only restricted eligibility rows, adjustments in effect and flagged collateral rows.
• maxRequests — a cap for long backfills (default 300).
• useApifyProxy — for multi-year TWSE backfills; TWSE's firewall blocks an address that asks too often.

Limitations, stated plainly

• TPEx does not publish the size of a margin adjustment, only that one applies and why. margin_ratio_cut_tenths and short_margin_raise_tenths are null on TPEx rows rather than guessed.
• The TWSE margin-adjustment publication describes the next business day, per the exchange's own note. date is the publication date. A date after the latest publication is not requested, because the report answers such a request with the previous publication under the new date.
• The collateral report's next-day limit differs from the margin-trading report's for about half of stocks (1,294 compared, 687 equal on 2026-09-29) by more than rounding. Both are official; this Actor publishes the collateral report's figure verbatim and does not pick one.
• Borrow fees cover day-trade delivery failures, which is the only per-stock, per-day borrowing price either exchange publishes. It is not the negotiated rate in the securities lending market.
• The 暫停借券賣出 column has been empty on every date sampled in both markets. It is parsed and published, not assumed.

Source

Taiwan Stock Exchange (臺灣證券交易所): TWT92U 平盤下得融(借)券賣出之證券名單, TWT96U 當日可借券賣出股數, BFIF8U 應付現股當日沖銷券差借券費率, BFIB9U 調整融資融券成數股票資訊, BFI84U 停券預告表, TWTA1U 借貸款項擔保品餘額表, plus TWT93U for verification. Taipei Exchange (證券櫃檯買賣中心): margin/mark, intraday/fee, margin/adjust, margin/term, plus margin/sbl for verification.

Taiwan Market Data Suite

This Actor is part of a suite of 44 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:

• taiwan-corporate-bonds — Every corporate, bank & Formosa bond — terms, balance, ratings & ISINs, daily OTC trades since 2005 and USD bond fair values since 2017
• taiwan-securities-lending-balance — Shares on loan for every stock since 2004 by lending channel, every SLB trade with its borrow fee rate, and each firm's lending book
• taiwan-ipo-listings — Every TWSE & TPEx listing application since 2000 from filing to first trading day — review, approval, price, underwriter & withdrawals, plus delistings
• taiwan-board-directors — Every independent director's career and other board seats linked to stock codes, board rosters, chair/CEO duality & director elections
• taiwan-broker-financials — Every securities firm's monthly balance sheet & P&L since 2013, full trial balance, and the register of firms & branches
• taiwan-short-sale-eligibility — Can it be shorted today? Below-close short list, shares available to borrow, borrow fees, margin haircuts & forced cover dates
• taiwan-gold-spot — The Taipei Exchange physical gold board since 2015 — daily VWAP, traded high/low, market-maker spread and every print by firm and price
• taiwan-convertible-bonds — Daily bars for every convertible bond on the Taipei Exchange, with conversion price, conversion window, put date & put price
• taiwan-corporate-action-prices — Capital reductions, par value changes & ETF splits — the official reopening price & adjustment factor for every price discontinuity since 2011
• taiwan-ipo-subscription — Every IPO ballot since 2006 & every competitive auction since 2016 — odds, ticket cost, reserve & bid-to-cover
• taiwan-intraday-5sec-stats — Market-wide order book & all sector indices every 5 seconds since 2004, 3,241 rows a session
• taiwan-stock-daily-quotes — Daily OHLCV, VWAP, P/E, price-to-book & dividend yield for every listed/OTC stock since 2004
• taiwan-index-history — Daily TAIEX & TPEx index history since 1990 with market turnover, the total-return index & all 273 TWSE indices
• 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-director-compensation — Board pay for 1,950+ companies, parent vs consolidated scope, with EPS, ROE & profit on the same row
• taiwan-esg-disclosures — 21 ESG topics for 1,950+ companies — Scope 1/2/3 emissions, energy, water, waste, pay, board & climate risk
• 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-short-sale-volume — Daily short sale turnover per stock — margin & borrowed lots, value and implied price, since 2008
• taiwan-day-trading-stats — Day-trading volume, value & ratio per stock since 2014
• taiwan-odd-lot-trading — Both odd-lot sessions per stock — intraday & after-hours, shares, turnover, OHLC & quotes since 2004
• taiwan-broker-rankings — Securities-firm turnover, market share & the top firms in each hot stock on the OTC board since 2007
• tdcc-shareholding-dispersion — Weekly TDCC shareholding dispersion (retail vs whale structure)
• taiwan-foreign-shareholding — Foreign ownership percentage & remaining quota per stock
• taiwan-futures-daily — Daily bars, settlement price & open interest for all 384 TAIFEX futures contracts since 1998, with the large-trader report
• taifex-institutional-derivatives — Institutional futures & options positions (TAIFEX), incl. put/call ratio
• taifex-options-chain — Full options chain by strike & expiry, both sessions, with the exchange's own Delta, since 2001
• taiwan-warrants-daily — Daily quotes, strike, expiry & moneyness for every listed/OTC warrant since 2004
• taiwan-government-bonds — Central government bond benchmark yields, the full yield curve & issuance master, with staleness stated
• 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)