Plan: Professional and above · Credits: 1 per call
What You Can Use Taiwan Financials For
Build a quarterly revenue and margin history for a Taiwan-listed company. Compare a quarter against the same quarter a year earlier. Pair the quarterly statements with Taiwan Monthly Revenue, which reports far sooner.Taiwan Income Statements Are Filed Cumulatively
Because of that, every income line comes back twice. The_ytd fields — revenue_ytd and its siblings — are the figure as filed, cumulative.
The _q fields — revenue_q and its siblings — are the single quarter.
How to Read quarter_basis
quarter_basis says how the _q value was arrived at.
as_reported means season 1, where the cumulative figure is already the quarter and no arithmetic was applied.
derived_from_ytd means this season’s cumulative figure minus the previous season’s.
null means the previous season is missing, in which case the _q fields are null. Those nulls must not be treated as zero.
Income Rows and Balance Rows Are Different Shapes
statement is income or balance. There is no cash-flow statement in this dataset.
Balance-sheet rows are point-in-time: never cumulative and never derived. Their income columns are null, and income rows have null balance columns.
Taiwan Financials Date Convention
year is the fiscal year and season is the TWSE season, 1 to 4. A season is a fiscal quarter, but because income is filed cumulatively, the season number describes the end of the cumulative window on the _ytd fields and the quarter itself on the _q fields.
Taiwan Financials Units
Amounts are TWD thousands. The response statescurrency and unit explicitly — read them rather than assuming a scale.
Taiwan Financials Sources
Statements are filed by the companies with the Taiwan exchanges. The_ytd values are as filed. The _q values are computed by FocusAlpha except in season 1, and quarter_basis says which case each row is.
Query Taiwan Financials
Use the Taiwan financials endpoint. It accepts a Taiwan security code such as2330, a suffixed ticker such as 2330.TW, an ISIN or a company_id directly — there is no need to resolve the identifier first.
string
required
A Taiwan security code, a suffixed ticker, an ISIN or a
company_id.string
income or balance. Both by default.integer
Fiscal year.
integer
TWSE season, 1 to 4.
integer
default:"40"
Rows per page, between 1 and 1000. Page through with
cursor.