🇹🇼 TWSE Stock Screener — Taiwan Market Quotes & Fundamentals

Track every stock on the Taiwan Stock Exchange (TWSE) — daily prices, volume, market cap, P/E, P/B, dividend yield, industry classification — sourced directly from the official TWSE OpenAPI. The Bloomberg Terminal alternative for Taiwanese equities, priced for indie quants and Asia-focused funds.

Taiwan is one of the most strategically important equity markets on earth — home to TSMC (the most valuable semiconductor company in the world), MediaTek, Foxconn (Hon Hai), and the entire global supply chain for advanced-node chips. And yet outside of Taiwan it remains one of the most under-instrumented major markets on the open web. Yahoo Finance has spotty TWSE coverage and lags badly on Taiwan-specific signals. Refinitiv and Bloomberg charge $20K+/year. The TWSE's own paid feed is mainly aimed at institutional brokers. This actor is built for the rest of us — solo traders, quant researchers, fintech builders, Asia hedge-fund analysts, and anyone running market-neutral or factor strategies that need genuine Taiwan coverage.

The data comes straight from openapi.twse.com.tw — Taiwan Stock Exchange's free, public, no-auth-required JSON OpenAPI. We merge three endpoints (daily price action, valuation ratios, and the static company-info table including industry codes) into a single clean record per ticker.

🎯 What you get per stock

Every record returned includes:

Field	Description
symbol	4-digit TWSE ticker (e.g. 2330 for TSMC, 2317 for Foxconn)
name	Short Chinese name (e.g. 台積電, 鴻海)
company_name_zh	Full registered Chinese company name
name_short_zh	TWSE short name (公司簡稱)
market	Always TWSE (this actor focuses on the main board)
trade_date	ISO date of the price snapshot
price_twd	Closing price in New Taiwan Dollars
open_twd / high_twd / low_twd	Day's OHLC
change_twd	Today's price change (signed)
pct_change	Today's percentage change (signed, 4 decimals)
volume_shares	Today's share volume
trade_value_twd	Today's TWD-denominated trade value (price × volume)
transactions	Number of distinct trades executed
pe_ratio	Trailing Price-to-Earnings ratio
pb_ratio	Price-to-Book ratio
dividend_yield_pct	Trailing dividend yield (%)
dividend_year_ad	The fiscal year of the dividend (Western calendar)
fiscal_year_quarter	Most recent reported quarter (e.g. 2025Q4)
industry_code	TWSE industry-classification code (24 = Semiconductor, 17 = Finance)
industry_name_en	English label for the industry code
shares_outstanding	Estimated from paid-in capital ÷ par value (10 TWD)
paid_in_capital_twd	Paid-in capital in TWD (from the company-info table)
market_cap_twd	Synthetic market cap (shares × close price)
chairman / ceo / spokesperson	Officer names from MOPS company filing
phone / address	HQ contact info
established_date / listing_date	ISO dates from MOPS
twse_url	Direct link to the company's MOPS filings page
scraped_at	UTC timestamp of the scrape

🚀 Quick start

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("nexgendata/twse-stock-screener").call(run_input={
    "limit": 200,
    "min_trade_value_twd": 100_000_000,  # 1億 TWD/day liquidity floor
    "min_dividend_yield": 4.0,            # high-yield Taiwan classics
})

for stock in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{stock['symbol']:<6} {stock['name']:<10} "
          f"NT${stock['price_twd']:>8,.2f}  "
          f"P/E {stock['pe_ratio']:>6}  "
          f"Yield {stock['dividend_yield_pct']:>5}%  "
          f"{stock['industry_name_en']}")

Sample output:

2330   台積電      NT$1,090.00  P/E   24.5  Yield  1.84%  Semiconductor
2317   鴻海        NT$  205.50  P/E   13.7  Yield  2.45%  Other Electronics
2454   聯發科      NT$1,415.00  P/E   22.1  Yield  4.91%  Semiconductor
2882   國泰金      NT$   72.40  P/E   10.2  Yield  4.83%  Finance & Insurance
2412   中華電      NT$  126.50  P/E   24.1  Yield  3.95%  Communications & Internet
...

🌐 cURL

curl -X POST "https://api.apify.com/v2/acts/nexgendata~twse-stock-screener/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"limit":50,"sector":"半導體"}'

📊 Real-world use cases

• Semiconductor supply-chain analysis — Taiwan hosts the entire global advanced-node fab capacity. Pull industry_code: "24" (Semiconductor) plus "28" (Electronic Parts/Components) to map the TSMC, MediaTek, ASE, Win Semi, Powerchip, Vanguard, UMC value chain in one query.
• Quant research — pull the full TWSE universe nightly, build factor models on P/E, P/B, dividend yield, and price momentum without paying a six-figure data subscription.
• High-dividend Taiwan strategy — Taiwan is famous for 5–8% sustainable dividend yields among large-caps. Set min_dividend_yield: 5.0 and screen the ETF-tier names (Cathay Financial, Chunghwa Telecom, Yuanta FHC, Taiwan Cement, etc.).
• Asia macro dashboards — track which TWSE sectors are rallying on TWD strength/weakness; Taiwan is one of the cleanest barometers of global tech demand.
• Taiwan-versus-Korea comparisons — pair this actor with the KOSPI Stock Screener to build cross-market relative-value screens (e.g. TSMC vs Samsung Electronics, MediaTek vs SK Hynix).
• Taiwan-versus-China relative value — pair with Eastmoney China Stock Screener to compare A-share semis (SMIC, Hua Hong) against Taiwan-listed equivalents.
• ETF construction — define your own TW50 or High-Dividend-30 alternative by filtering on minimum trade value and rebalancing weekly.
• Hedge-fund daily refresh — schedule via the Apify scheduler at the post-close (13:30 TWT = 05:30 UTC) and pipe the dataset into your warehouse.
• Fintech app data layers — power a Taiwan-equity widget for your robo-advisor, trading-journal app, or portfolio tracker. The chairman/ceo fields make great enrichment for company-detail screens.
• Academic finance research — Taiwan retail-investor behavior is heavily studied (Barber, Lee, Liu, Odean's foundational papers all use TWSE data); this actor gives reproducible market snapshots without scraping headaches.
• News + sentiment overlays — join with company-name lookups to attribute Chinese-language news flow back to ticker IDs.
• Geopolitical risk monitoring — when cross-strait tensions move, Taiwan equities reprice within minutes. Schedule this actor hourly during volatile windows for a clean snapshot of which sectors are absorbing the shock.

⚙️ Input parameters

Param	Type	Default	Notes
limit	int	200	Max stocks returned, sorted by trade value desc (1–2000)
min_trade_value_twd	int	0	Liquidity floor in TWD daily trade value
min_volume	int	0	Filter to stocks with daily volume above this
max_pe_ratio	number	0	Value screen — max P/E (0 disables)
min_dividend_yield	number	0	Income screen — min trailing yield %
sector	string	""	Substring match on industry name/code or company name (Chinese or English)
include_etfs	bool	false	Include 0050-style ETFs and warrants alongside common stocks
proxyConfiguration	object	datacenter	Apify proxy config

Examples

Top 10 by liquidity (fast smoke test):

{ "limit": 10 }

Taiwan semiconductor universe:

{ "limit": 100, "sector": "半導體" }

Or in English:

{ "limit": 100, "sector": "semiconductor" }

High-dividend Taiwan classics:

{ "limit": 50, "min_dividend_yield": 5.0, "min_trade_value_twd": 100000000 }

Deep-value screen:

{ "limit": 100, "max_pe_ratio": 12, "min_trade_value_twd": 50000000 }

Full TWSE universe including ETFs:

{ "limit": 2000, "include_etfs": true }

💰 Pricing

This actor uses pay-per-event pricing — you only pay for what you actually pull.

• Actor start: $0.005 per run
• Stock record: $0.02 per stock returned

So a typical 200-stock screen costs roughly $4.00. The full TWSE common-stock universe (~1,000 names) is about $20.00 — a one-time payment for what would otherwise be a Refinitiv subscription seat. Compare to:

• Bloomberg Terminal — $24,000/year minimum
• Refinitiv (LSEG) Eikon — $22,000+/year
• TWSE direct paid feed — institutional contract minimums, brokerage relationships required

This actor pays for itself the first time you'd otherwise have spun up a Taiwan-resident brokerage account just for the data.

🔬 Data sources & methodology

We merge three TWSE OpenAPI endpoints:

1. exchangeReport/STOCK_DAY_ALL — daily OHLC, volume, transaction count for every TWSE-listed security (~1,350 records including ETFs and warrants).
2. exchangeReport/BWIBBU_d — daily P/E ratio, P/B ratio, and trailing dividend yield for common stocks (~1,070 records).
3. opendata/t187ap03_L — the static company-info table — industry classification (產業別), full company name, paid-in capital, chairman, listing date, MOPS contact info (~1,080 records).

The merge happens in-memory on a single Code/公司代號 join. Market cap is synthesized as paid_in_capital ÷ par_value × close_price (par value is 10 TWD by Taiwan convention). This is approximate but close to the official market cap reported on MOPS and the Goodinfo screener — the deviation comes from preferred shares and convertible securities, which are typically <2% of total share count for liquid TWSE names.

The TWSE OpenAPI does not require authentication, has no published rate limit (we throttle politely anyway), and is updated each trading day after the 13:30 TWT close. Weekends and Taiwanese public holidays will return the most recent trading day's snapshot.

🤔 FAQ

Q: Is the data real-time? The TWSE OpenAPI is end-of-day, refreshed after each 13:30 TWT (05:30 UTC) market close. Pre-market and intra-day snapshots are not available through this endpoint. For sub-second tick data you need a paid TWSE licensee or a Taiwan brokerage account.

Q: What about TPEx / 櫃買中心 (Taipei Exchange OTC stocks)? This actor covers the main TWSE board only — that's where the bulk of liquidity and the largest companies (TSMC, Foxconn, MediaTek, etc.) trade. TPEx coverage is on the roadmap. File an issue on the actor page if you need it sooner.

Q: Why is pe_ratio empty for some stocks? Loss-making companies have no meaningful P/E (denominator is zero or negative). The TWSE BWIBBU endpoint returns an empty string in those cases, which we propagate as null. ETFs also have no P/E since they're funds, not operating companies.

Q: My CSV has Chinese characters that look like garbage. Save the file as UTF-8 with BOM and open in Excel via Data → From Text/CSV. Or use pandas.read_csv(..., encoding='utf-8-sig') in Python.

Q: How do I match Chinese names to English company labels? Most major TWSE names map cleanly: 台積電 = TSMC, 鴻海 = Hon Hai (Foxconn), 聯發科 = MediaTek, 國泰金 = Cathay Financial Holding, 中華電 = Chunghwa Telecom, 富邦金 = Fubon Financial Holding, 台達電 = Delta Electronics, 日月光 = ASE Technology Holding. For systematic mapping, query the TWSE ISIN service or use the Yahoo Finance .TW suffix.

Q: Can I use this commercially? The data comes from the TWSE's official public OpenAPI, which the Taiwan Stock Exchange itself publishes for public consumption. You own the output dataset. For redistribution as a paid product or syndication, consult TWSE's Open Data terms and consider a direct data licensing arrangement.

Q: How does this differ from the Eastmoney China actor? Different markets, different data sources. Eastmoney covers Shanghai (SSE) and Shenzhen (SZSE) A-shares scraped from East Money Network. This actor covers Taiwan-listed (TWSE) stocks via the official TWSE OpenAPI. Use both together for a complete Greater China equity view.

Q: Is this maintained? Yes — NexGenData maintains 170+ Apify actors and ships fixes within 24 hours of bug reports. File issues via the Apify console's Issues tab on this actor's page.

Q: Why pay for this when I could call the TWSE OpenAPI myself? You could! But you'd spend a weekend dealing with three separate endpoints with inconsistent date formats (ROC vs Western calendar), undocumented column meanings (產業別 codes), the merge logic across three tables, the par-value-based market-cap reconstruction, ETF/warrant filtering rules, and figuring out why some stocks have empty P/Es. Or you can pay $4 per 200-stock run and get clean JSON in 10 seconds.

🔗 Related NexGenData actors

• 🇰🇷 KOSPI Stock Screener — same proven pattern, for Korean equities (KOSPI + KOSDAQ)
• 🇨🇳 Eastmoney China Stock Screener — Shanghai/Shenzhen/ChiNext/STAR Market A-shares
• 📈 Finviz Stock Screener — US equities with 70+ filters
• 💹 Finance MCP Server — unified Claude/ChatGPT-tool wrapper for the full NexGenData finance fleet
• 📊 Yahoo Finance Scraper — historical OHLCV, statistics, options chain (works with .TW-suffixed Taiwan tickers)

📚 More from NexGenData

Visit thenextgennexus.com for:

• 📝 Tutorials on web scraping, data extraction, and AI workflows
• 🧰 The full catalog of 170+ actors, REST APIs, and MCP servers
• 📦 Ready-made data packs on Gumroad
• 📨 The NexGenData newsletter

🚀 Apify affiliate program

New to Apify? Sign up with our referral link — you get free platform credits on signup, and you help fund the maintenance of this actor fleet.

---

Built and maintained by NexGenData — 170+ actors covering scraping, enrichment, MCP servers, and automation. Home: thenextgennexus.com.