Assets held by the central bank in foreign currencies, used to support the exchange rate and manage monetary policy. Key indicator of a country's external financial position.
Category: Monetary Policy
API Endpoint
/api/v1/announcements/eur/foreign_reserves
Use the production OpenAPI schema for the authoritative REST route metadata.
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
UnavailableTemporarily hidden for this currency in the API catalogue.
inflation_mom
Available
About Foreign Exchange Reserves (EUR)
The foreign reserves of Eurozone encompass foreign currency holdings, special drawing rights (SDRs), IMF reserve positions, and gold held by the European Central Bank. They represent the country's international liquidity buffer.
Why FX traders watch it
A large reserves buffer increases confidence in the eur by demonstrating the European Central Bank's capacity to meet external obligations and intervene in FX markets. Reserves below 3 months of import cover are often cited as a vulnerability threshold.
How to interpret the data
Increasing foreign reserves are eur-positive as they signal financial strength and intervention capacity. A sustained draw-down of reserves can trigger speculative attacks on the eur.
Historical Foreign Exchange Reserves (EUR)
Source: ECB/Eurostat
· Monthly
· EUR mn
Chart data not available. Access the full historical series via the API endpoint above.
This page documents the exact request inputs, response fields, access model, and currently published history window for
/api/v1/announcements/eur/foreign_reserves.
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 extend the window for USD or to access any other currency. Date filters are applied before pagination. The default page size is 20 rows and the maximum is 100. Forecasts are served separately by /v1/predictions/eur; join via `announcement_id`.
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. Defaults to 365 days ago.
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.
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 and offset.
The response includes earliest_available_date and latest_available_date for the full series coverage, 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.
Example Usage
To retrieve the first page of Foreign Exchange Reserves data for EUR from 2023:
GET https://fxmacrodata.com/api/v1/announcements/eur/foreign_reserves?start_date=2023-01-01&end_date=2023-12-31&limit=20&offset=0&api_key=YOUR_API_KEY
Frequently Asked Questions
How often is Eurozone Foreign Exchange Reserves updated?
Foreign Exchange Reserves for Eurozone is released on a monthly schedule by European Central Bank (or the relevant national statistics agency). FXMacroData ingests each new value within seconds of the official publication and exposes the exact announcement timestamp on every record.
What unit is Foreign Exchange Reserves reported in?
The series is published in EUR mn. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Eurozone Foreign Exchange Reserves data?
Data is fetched directly from European Central Bank or the official national statistics publication for Eurozone. The source URL is preserved on every announcement record so downstream consumers can trace the value back to its primary release.
How do I query Foreign Exchange Reserves for Eurozone via the API?
Issue a GET request to /api/v1/announcements/eur/foreign_reserves?api_key=YOUR_API_KEY. The response contains a chronological list of observations with values, release dates, and announcement timestamps. USD announcement data is public; other currencies require a Professional API key.