Optional indicators use per-currency fetcher capability checks and may be temporarily hidden while source coverage is being remediated.
foreign_reserves
UnavailableTemporarily hidden for this currency in the API catalogue.
cb_assets
UnavailableNot implemented on this currency fetcher yet.
inflation_mom
UnavailableNot implemented on this currency fetcher yet.
About Gross Domestic Product (GDP) Growth (TWD)
Taiwan's Gross Domestic Product (GDP) measures the total inflation-adjusted value of all goods and services produced by the economy, released quarterly. It is the broadest single gauge of economic health and is closely tracked by the Central Bank of the Republic of China when setting monetary policy.
Why FX traders watch it
GDP is a primary driver of central bank rate decisions—strong growth raises the probability of tighter monetary policy, which tends to support the twd. Divergences in growth between two economies are a core foundation of FX fundamental analysis.
How to interpret the data
A print above consensus suggests the Taiwan economy is expanding faster than expected, which is broadly positive for the twd. A miss can fuel rate-cut expectations and weaken the currency. Revisions to prior quarters can be as market-moving as the headline release.
USD is free without a key. All other currencies require a Professional API key.
Public USD endpoint — anonymous callers receive the most recent 365 days. Add `?api_key=YOUR_API_KEY` to page through full stored USD history or to access any other currency. Date filters are applied before pagination. The default page size is 20 rows and the maximum is 100. Use either `page` or `offset`; when both are provided, `page` takes precedence. Forecasts are served separately by /v1/predictions/twd; join via `announcement_id`.
Data source and provenance
Macroeconomic announcement and catalogue rows are normalized from official central-bank, national statistics, treasury, or government publisher releases. Responses expose publisher metadata via source, source_url, and provenance fields where available.
Responses expose source, source_url, and provenance fields so consumers can cite the upstream publisher and FXMacroData serving path.
Path parameters
Parameter
Required
Type
Description
currency
YES
string
3-letter currency code.
indicator
YES
string
Indicator slug. Use /v1/data_catalogue/{currency} to list available slugs per currency.
Query parameters
Parameter
Required
Format
Description
start_date
NO
string (YYYY-MM-DD)
Earliest observation date to include. Date filters are applied before pagination. Authenticated requests page through full stored history when omitted; anonymous USD requests are limited to the most recent 365 days.
end_date
NO
string (YYYY-MM-DD)
Latest observation date to include. Defaults to today.
limit
NO
integer
Maximum number of rows to return per page. Defaults to 20; maximum 100.
page
NO
integer
One-based page number. When supplied, page takes precedence over offset; page=2 with limit=20 is equivalent to offset=20.
offset
NO
integer
Zero-based row offset after date filtering. Use with pagination.next_offset to request the next page.
api_key
Pro (USD: free for last 365 days)
string
Professional API key. Required for non-USD currencies and for USD requests that need history older than 365 days.
Pagination behavior
Use start_date and end_date to narrow the series first, then page through the filtered result with limit plus either page or offset.
The default page size is 20 rows and the maximum is 100. page is one-based; offset is zero-based, and page takes precedence when both are supplied.
Authenticated announcement requests without start_date page through the full stored history; anonymous USD requests are limited to the freemium window.
The response includes earliest_available_date and latest_available_date for the series coverage inside the requested date window, plus a pagination object with
returned_count, total_count, has_more, and next_offset.
Response fields
Field
Type
Description
currency
string
3-letter currency code.
indicator
string
Indicator slug as requested.
has_official_forecast
boolean
True if the central bank publishes an official forecast for this indicator.
start_date
string
Earliest date in the filtered result set (YYYY-MM-DD).
end_date
string
Latest date in the filtered result set (YYYY-MM-DD).
earliest_available_date
string | null
Earliest date available for this series before any date filter or pagination is applied.
latest_available_date
string | null
Latest date available for this series before pagination is applied.
pagination.limit
integer
Page size used for this response.
pagination.offset
integer
Zero-based offset used for this response.
pagination.returned_count
integer
Number of rows included in data[].
pagination.total_count
integer
Total number of rows matching the path and date filters before pagination.
pagination.has_more
boolean
True when another page is available.
pagination.next_offset
integer | null
Offset to use for the next page, or null when there are no more rows.
cb_target
object | null
Central bank target metadata (e.g. inflation target range), if applicable.
data[].date
string
Observation date (YYYY-MM-DD).
data[].announcement_id
string
Stable announcement identifier in the form `{currency}_{indicator}_{date}` — use it to join predictions from /v1/predictions/{currency} and revision history.
data[].val
number | null
Observed value in the indicator's native unit.
data[].announcement_datetime
integer | null
Unix timestamp (UTC) of the official data release.
data[].pct_change
number | null
Period-over-period percentage change.
data[].pct_change_12m
number | null
12-month rolling percentage change.
source
string
Human-readable upstream publisher or source family for this response.
source_url
string | null
Official publisher URL or source landing page when available.
provenance
object
Structured provenance metadata including publisher, storage layer, served_by, timestamp field, and value field.
source_series_name
string | null
Publisher's source-series label when FXMacroData stores one.
source_local_name
string | null
Local-language or publisher-native series name when available.
provenance.publisher
string
Official upstream publisher for the requested currency/indicator series.
provenance.storage
string
FXMacroData serving storage layer, typically FXMacroData Firestore.
Example Usage
To retrieve the first page of Gross Domestic Product (GDP) Growth data for TWD from 2023:
GET https://fxmacrodata.com/api/v1/announcements/twd/gdp?start_date=2023-01-01&end_date=2023-12-31&limit=20&page=1&api_key=YOUR_API_KEY
Frequently Asked Questions
How often is Taiwan GDP released?
GDP for Taiwan is published on a quarterly basis, typically with an advance estimate followed by revision rounds.
What unit is Taiwan GDP measured in?
The series is expressed in %YoY.
Who publishes Taiwan GDP data?
The official source is Central Bank of the Republic of China or the national statistics agency. FXMacroData delivers this series with announcement timestamps via the /api/v1/announcements/twd/gdp endpoint.