Taiwan Stock Daily Quotes — 台股行情 OHLCV API
Pricing
from $0.50 / 1,000 results
Daily OHLCV for every security on the Taiwan Stock Exchange and Taipei Exchange, with P/E, price-to-book and dividend yield joined on. TWSE reaches back to 2004-02-11, TPEX to 2007-07-02. Ex-rights sessions are flagged, not silently mispriced.
Trading date
date
Optional
The session this quote belongs to, as YYYY-MM-DD. The exchanges publish Republic-of-China years (115/08/14); they are converted here.
Market
market
Optional
TWSE for the listed board (上市), TPEX for the over-the-counter board (上櫃).
Security code
code
Optional
The ticker. Not always numeric — 00681R, 2348A and 2887G are ordinary codes — so it is always text.
Security name
name
Optional
The exchange's short name in Chinese.
Open
open
Optional
Opening price in TWD. Null when the security did not trade — the exchange prints dashes rather than zeroes.
High
high
Optional
Highest price of the regular session, in TWD.
Low
low
Optional
Lowest price of the regular session, in TWD.
Close
close
Optional
Closing price in TWD.
Change
change
Optional
The change the exchange printed, in TWD, signed. Null when the exchange marked the session not comparable to the previous one — see change_basis.
Change (%)
change_pct
Optional
change divided by previous_reference_price, as a percentage. Computed here from the two printed numbers rather than read off the report, which does not carry it.
Reference price the change was measured against
previous_reference_price
Optional
close minus change. On an ordinary session this is the previous close; on an ex-rights session it is the ex-rights reference price. change_basis says which, once the previous session has been seen.
Previous close
previous_close
Optional
The close of the previous session for this security, when that session was part of the same run. Null on the first row of a series, since the report does not carry it.
What the change was measured against
change_basis
Optional
PREVIOUS_CLOSE when previous_reference_price matches the previous session's close. EX_RIGHTS_REFERENCE when it does not, which is how an ex-rights session shows up on TPEX's per-security report — that report carries no marker and prints a change measured against the adjusted reference price. PRICE_NOT_COMPARABLE when the exchange itself said so: TWSE writes X in place of the change on an ex-rights session, and TPEX's whole-board report writes 除息, 除權 or 除權息. UNVERIFIED when the previous session was not part of this run.
Ex-rights marker
ex_rights_marker
Optional
息 for ex-dividend, 權 for ex-rights, 權息 for both, as printed by TPEX's whole-board report. IMPLIED when no marker was printed but the change does not reconcile with the previous close. Null otherwise. TWSE does not distinguish the three cases; its ex-rights sessions show up as change_basis PRICE_NOT_COMPARABLE.
Turnover (TWD)
turnover_value
Optional
Value traded in New Taiwan dollars. TPEX's per-security report publishes this in thousands (成交仟元) and it is scaled up here, so it is exact only to the nearest NT$1,000.
Trade count
transactions
Optional
Number of matched trades in the session.
Average price
average_price
Optional
turnover_value divided by volume_shares — the session's volume-weighted average price, which neither exchange publishes.
Last bid
last_bid_price
Optional
Best bid at the close. Only the whole-board reports carry it; null on rows read from a per-security report.
Last ask
last_ask_price
Optional
Best ask at the close. Whole-board reports only.
Next session's limit up
next_limit_up
Optional
The following session's ceiling price. TPEX whole-board rows only.
Next session's limit down
next_limit_down
Optional
The following session's floor price. TPEX whole-board rows only.
P/E ratio
pe_ratio
Optional
Price to earnings as the exchange publishes it. Null where the exchange prints a dash or a zero, which is what it does for a loss-making company and for every ETF.
Price-to-book ratio
pb_ratio
Optional
Price to net asset value per share, as published.
Dividend yield (%)
dividend_yield_pct
Optional
Trailing dividend yield as published by the exchange.
Dividend year (ROC)
dividend_year_roc
Optional
The Republic-of-China year the dividend belongs to. 114 is 2025.
Financial statement period
fiscal_period
Optional
The reporting period behind the P/E and price-to-book, as the exchange labels it — 115/1 on TWSE, 115Q1 on TPEX. Not published before roughly 2016.
Yield reconciles with the published dividend
dividend_yield_matches_dividend
Optional
Whether dividend_per_share divided by close reproduces dividend_yield_pct to the exchange's two decimals. TPEX rows only, since it is the only source that publishes both. Reliably true on recent sessions and mostly false before about 2015, when the exchange's two columns did not yet agree.
Which official report this row came from
source_report
Optional
TWSE STOCK_DAY and TPEX tradingStock are the per-security monthly reports; TWSE MI_INDEX and TPEX otc are the whole-board daily ones. TWSE's two agree to the last digit. TPEX's agree on price but not on volume or turnover, with the per-security figure the larger by 0-6%.
OHLC ordering holds
ohlc_consistent
Optional
Whether low is at or below both open and close, and high at or above both. Null when the security did not trade and has no prices.
Average price inside the day's range
average_price_in_range
Optional
Whether turnover divided by volume lands between low and high. A false is not an error: both exchanges fold block trades into the daily totals, and a block prices against the previous close rather than the day's band, so one large off-band print pulls the average outside.
