All APIs

MOPS API for Taiwan filings and statements

Get financial statements for about 1,980 companies listed on TWSE and TPEx in Taiwan. The API currently covers the 2026 half-year reports.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/twn:2330/financials?period=semiannual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "id": "twn:2330",
  "currency": "TWD",
  "semiannual": [
    {
      "fy": 2026,
      "fh": 1,
      "end": "2026-06-30",
      "derived": [],
      "revenue": "2404483690000",
      "net_income": "1279041690000",
      "total_assets": "9375654727000"
    }
  ],
  "as_of": "2026-10-24"
}

Endpoints

GETList companies/v1/companies
GETList a company's filings/v1/companies/{company_id}/filings
GETGet standardised company financial statements/v1/companies/{company_id}/financials

Taiwan financial statement coverage

TWSE OpenAPI and TPEx open data

We use Taiwan Stock Exchange (TWSE) OpenAPI and Taipei Exchange (TPEx) open data on data.gov.tw under the Taiwan Open Government Data Licence v1.0. These sources mirror MOPS filings.

Half-year figures

Income and per-share figures are year to date for the half year (period=semiannual). Annual figures will come with annual reports.

Whole Taiwan dollars

Money amounts are whole Taiwan dollars, scaled up from source values in thousands. Per-share figures such as EPS are decimals and are not scaled.

Coverage includes about 1,980 companies listed on TWSE and TPEx in Taiwan. Only the 2026 half-year reports are loaded. Annual figures will come with annual reports.

Explore related pages

ESEF API for annual company filings

Annual reports from companies in 26 EU and EEA countries

Explore the API →

UK filings API for companies on regulated markets

Annual reports from issuers on UK regulated markets

Explore the API →

Company filings API for lists and individual records

Filing lists, individual records and the latest filings across companies

Explore the API →

Common questions

How do Taiwan company IDs work?

A Taiwan company ID combines twn: with the stock code, such as twn:2330.

Which dates do balance sheets cover?

Balance sheets come at each report date.

Are Taiwan holders of 5% or more included?

No. Holders of 5% or more are not included for Taiwan.