Documentation
Production API Endpoint Documentation
Canonical public reference for the FX macro REST API. Covers announcements, market forecasts and predictions, release calendars, data discovery, COT positioning, precious metals, forex rates, and market sessions.
Base URL
https://fxmacrodata.com/api
Authentication
?api_key=YOUR_API_KEY
Append as a query parameter on request URLs
Endpoints
9 endpoints · 3 families
Access model
4
Always free
Calendar, data catalogue, forex, and market sessions require no API key.
Access model
1
Pro (USD free)
Announcements are mixed-access: USD is public, while non-USD currencies require a Professional API key.
Access model
2
Pro key required
COT and commodities require a Professional API key for every request.
On This Page
Page Index
Jump to any section below. Use the sticky bar above to navigate while scrolling.
Quick Start Guide
How To Use FXMacroData Endpoints and Authentication
Start with one complete walkthrough covering authentication, endpoint families, real request examples, and the fastest way to move from testing USD endpoints to a production multi-currency integration.
What it covers
- Authentication with ?api_key=YOUR_API_KEY
- Announcements, predictions/forecasts, release calendar, COT, metals, forex, and sessions
- Request patterns for USD-free and pro-key endpoint usage
Endpoint family · 01 of 3
Macro data and discovery
Fetch normalized macroeconomic indicator series with announcement timestamps, browse upcoming release schedules, and discover available indicators per currency.
/api/v1/announcements/{currency}/{indicator}
Pro key · USD free
Historical macroeconomic indicator series with announcement timestamps.
USD is free without a key. All other currencies require a Professional API key.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency |
string | required |
3-letter currency code.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd, cny, sgd, sek, dkk, pln, brl |
indicator |
string | required |
Indicator slug. Use /v1/data_catalogue/{currency} to list available slugs per currency.
e.g. gdp, inflation, core_inflation, policy_rate, unemployment |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date |
string (YYYY-MM-DD) | optional |
Earliest date to include. Defaults to 365 days ago.
e.g. 2025-01-01 |
end_date |
string (YYYY-MM-DD) | optional |
Latest date to include. Defaults to today.
e.g. 2026-03-01 |
api_key |
string | pro/free |
Professional API key. Required for non-USD currencies.
e.g. YOUR_API_KEY |
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 returned series (YYYY-MM-DD). |
end_date |
string | Latest requested end date (YYYY-MM-DD). |
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 request
Public USD endpoint — no API key needed. Forecasts are served separately by /v1/predictions/{currency}; join via `announcement_id`.
Supported currencies (14)
/api/v1/predictions/{currency}
Pro key · USD free
Forecasts/predictions linked to announcements via announcement_id (market consensus, central-bank forecasts, IMF WEO, surveys).
USD is free without a key. All other currencies require a Professional API key.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency |
string | required |
3-letter currency code.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
indicator |
string | optional |
Optional indicator slug filter (e.g. inflation, policy_rate).
e.g. inflation, policy_rate, unemployment |
prediction_type |
string | optional |
Filter by forecast category: market_consensus, market_prediction, survey, central_bank_forecast, imf_weo.
e.g. market_consensus, central_bank_forecast, imf_weo |
prediction_source |
string | optional |
Filter by source identifier (e.g. philly_fed_spf, ecb_spf, imf_weo, rbnz_mps).
e.g. philly_fed_spf, ecb_spf, imf_weo |
start_date |
string (YYYY-MM-DD) | optional |
Earliest period date to include.
e.g. 2025-01-01 |
end_date |
string (YYYY-MM-DD) | optional |
Latest period date to include.
e.g. 2026-12-31 |
api_key |
string | pro/free |
Professional API key. Required for non-USD currencies.
e.g. YOUR_API_KEY |
Response fields
| Field | Type | Description |
|---|---|---|
currency |
string | Currency code as requested. |
indicator |
string | null | Indicator filter if provided, otherwise null. |
prediction_type |
string | null | Active prediction-type filter, if any. |
prediction_source |
string | null | Active prediction-source filter, if any. |
count |
integer | Number of announcement groups returned in data[]. |
prediction_count |
integer | Total number of per-source predictions across all announcement groups. |
data[].announcement_id |
string | Identifier of the announcement these forecasts target — matches data[].announcement_id on /v1/announcements/{currency}/{indicator}. |
data[].currency |
string | Currency of the forecasted indicator (lowercase). |
data[].indicator |
string | Indicator slug of the forecasted release. |
data[].date |
string | Reference period date of the forecast (YYYY-MM-DD). |
data[].announcement_datetime |
integer | null | Unix timestamp (UTC) of the forecasted announcement, when known. |
data[].predictions[].predicted_value |
number | Forecast value in the indicator's native unit. |
data[].predictions[].prediction_type |
string | null | Forecast category: market_consensus, market_prediction, survey, central_bank_forecast, imf_weo, fxmacrodata. |
data[].predictions[].prediction_source |
string | null | Stable identifier of the prediction data source. |
data[].predictions[].prediction_source_label |
string | null | Human-readable name for the prediction source. |
data[].predictions[].generated_at |
integer | null | Unix timestamp (UTC) when the prediction was generated, when available. |
Example request
Use the announcement_id to join each prediction with the realised observation returned by /v1/announcements/{currency}/{indicator}.
Supported currencies (14)
/api/v1/predictions/{currency}/{indicator}
Pro key · USD free
All available forecasts for one currency/indicator pair, linked via announcement_id.
USD is free without a key. All other currencies require a Professional API key.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency |
string | required |
3-letter currency code.
e.g. usd, eur, gbp, jpy |
indicator |
string | required |
Indicator slug. Use /v1/data_catalogue/{currency} to discover available slugs.
e.g. inflation, unemployment, policy_rate |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
prediction_type |
string | optional |
Filter by forecast category: market_consensus, market_prediction, survey, central_bank_forecast, imf_weo.
e.g. imf_weo |
prediction_source |
string | optional |
Filter by source identifier.
e.g. philly_fed_spf |
start_date |
string (YYYY-MM-DD) | optional |
Earliest period date.
e.g. 2025-01-01 |
end_date |
string (YYYY-MM-DD) | optional |
Latest period date.
e.g. 2026-12-31 |
api_key |
string | pro/free |
Professional API key. Required for non-USD currencies.
e.g. YOUR_API_KEY |
Response fields
| Field | Type | Description |
|---|---|---|
data[].announcement_id |
string | Identifier matching data[].announcement_id on /v1/announcements/{currency}/{indicator}. |
data[].announcement_datetime |
integer | null | Unix timestamp (UTC) of the forecasted announcement. |
data[].predictions[].predicted_value |
number | Forecast value in the indicator's native unit. |
data[].predictions[].prediction_type |
string | null | Forecast category. |
data[].predictions[].prediction_source |
string | null | Stable source identifier. |
data[].predictions[].prediction_source_label |
string | null | Human-readable name for the prediction source. |
data[].predictions[].generated_at |
integer | null | Unix timestamp (UTC) when the prediction was generated. |
Example request
Join predictions to actuals via the announcement_id field shared with /v1/announcements/{currency}/{indicator}.
Supported currencies (14)
/api/v1/calendar/{currency}
Free
Upcoming release dates for a currency and optional indicator filter.
Fully public — no API key required.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency |
string | required |
3-letter currency code or COMM for commodity release schedules.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd, cny, sgd, sek, dkk, pln, brl, COMM |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
indicator |
string | optional |
Optional filter to a specific indicator slug (e.g. inflation, gdp).
e.g. inflation, gdp, unemployment |
Response fields
| Field | Type | Description |
|---|---|---|
currency |
string | Currency code as requested. |
indicator |
string | null | Indicator filter if provided, otherwise null. |
data[].announcement_datetime |
integer | Unix timestamp (UTC) of the upcoming release. |
data[].release |
string | Indicator slug for this release row (e.g. inflation, policy_rate). |
data[].domain |
string | Present on non-announcement rows (e.g. cot). Identifies the data domain. |
data[].endpoint_family |
string | Endpoint family identifier for non-announcement rows (e.g. cot). |
data[].endpoint_path |
string | Suggested API path to fetch the full release data. |
data[].requires_api_key |
boolean | Whether the linked endpoint requires a Professional API key. |
data[].title |
string | Human-readable title for the release (present on extended domain rows). |
Example request
Returns all upcoming USD macro release dates. Filter by indicator with ?indicator=inflation.
Supported currencies (19)
/api/v1/data_catalogue/{currency}
Free
Available indicator metadata for a currency.
Fully public — no API key required.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency |
string | required |
3-letter currency code.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
include_capabilities |
boolean | optional |
If true, adds route and authentication discovery metadata per indicator.
e.g. true |
include_coverage |
boolean | optional |
If true, adds a per-currency availability grid across all supported currencies.
e.g. true |
Response fields
| Field | Type | Description |
|---|---|---|
{indicator_slug} |
object | Top-level key is the indicator slug (e.g. gdp, inflation, policy_rate). |
{slug}.name |
string | Human-readable indicator name. |
{slug}.unit |
string | Unit of measurement (e.g. %YoY, %QoQ, %). |
{slug}.frequency |
string | Release frequency (Monthly, Quarterly, Meeting, Daily). |
{slug}.has_official_forecast |
boolean | Whether the central bank publishes an official forecast. |
Example request
Lists all indicators available for USD with name, unit, and frequency metadata.
Supported currencies (14)
Endpoint family · 02 of 3
FX market structure and sentiment
Query spot FX pairs and inspect the live global trading-session schedule for market-timing workflows.
/api/v1/forex/{base}/{quote}
Free
Daily FX spot-rate series for a currency pair, with optional technical indicators.
Fully public — no API key required.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
base |
string | required |
Base currency 3-letter code.
e.g. EUR, GBP, USD, AUD |
quote |
string | required |
Quote currency 3-letter code.
e.g. USD, JPY, CHF, CAD |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date |
string (YYYY-MM-DD) | optional |
Start of the date range. Defaults to 365 days ago.
e.g. 2025-01-01 |
end_date |
string (YYYY-MM-DD) | optional |
End of the date range. Defaults to today.
e.g. 2026-03-01 |
indicators |
string | optional |
Comma-separated technical indicator slugs to append to each row (e.g. sma_20,rsi_14).
e.g. sma_20,rsi_14 |
Response fields
| Field | Type | Description |
|---|---|---|
base |
string | Base currency code. |
quote |
string | Quote currency code. |
start_date |
string | Earliest date in the series (YYYY-MM-DD). |
end_date |
string | Latest date in the series (YYYY-MM-DD). |
data[].date |
string | Trading date (YYYY-MM-DD). |
data[].val |
number | null | Spot rate for the pair on this date. |
indicators.{slug}.{date} |
number | null | Per-date value for the requested technical indicator (e.g. sma_20, rsi_14). Only present when indicators parameter is supplied. Multi-series indicators (macd, bollinger_bands) return nested dicts. |
Example request
Returns daily EUR/USD spot rates for the past year.
Supported currencies (14)
/api/v1/market_sessions
Free
Real-time FX market-session and overlap timetable.
Fully public — no API key required.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
at |
string (ISO-8601 UTC) | optional |
Optional reference timestamp for scheduling or back-testing. Defaults to current server time.
e.g. 2026-03-05T12:00:00Z |
Response fields
| Field | Type | Description |
|---|---|---|
now_utc |
string | Current server time in ISO-8601 UTC. |
now_unix |
integer | Current server time as Unix epoch. |
is_market_day |
boolean | False on weekends and major market holidays. |
sessions[].name |
string | Session name (Sydney, Tokyo, London, New York). |
sessions[].display_name |
string | Full descriptive name including region. |
sessions[].description |
string | Brief characterisation of the session. |
sessions[].currencies |
array | Currency codes most active during this session. |
sessions[].timezone |
string | IANA timezone for the session's home market. |
sessions[].open_utc |
string | Today's session open in ISO-8601 UTC. |
sessions[].close_utc |
string | Today's session close in ISO-8601 UTC. |
sessions[].is_open |
boolean | Whether the session is currently open. |
sessions[].seconds_to_open |
integer | null | Seconds until this session opens (null if already open or closed for the day). |
sessions[].seconds_to_close |
integer | null | Seconds until this session closes (null if not currently open). |
overlaps[].name |
string | Overlap window name (e.g. London / New York). |
overlaps[].sessions |
array | Session names that form this overlap. |
overlaps[].description |
string | Characterisation of liquidity during this overlap. |
overlaps[].priority |
string | Liquidity priority — high, medium, or low. |
overlaps[].notable_pairs |
array | Most actively traded pairs during this overlap. |
overlaps[].start_utc |
string | Overlap window start in ISO-8601 UTC. |
overlaps[].end_utc |
string | Overlap window end in ISO-8601 UTC. |
overlaps[].is_active |
boolean | Whether the overlap window is currently active. |
overlaps[].duration_hours |
number | Duration of the overlap in hours. |
Example request
Returns a real-time snapshot of all four sessions plus overlap windows. Use ?at=2026-03-05T08:00:00Z for a historical snapshot.
Endpoint family · 03 of 3
Market positioning and metals
CFTC Commitment of Traders positioning by currency and precious metals price series for cross-market analysis.
/api/v1/cot/{currency}
Pro key required
Weekly CFTC Commitment of Traders positioning by currency.
Always requires a Professional API key.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency |
string | required |
3-letter currency code. Maps to the corresponding CME FX futures contract.
e.g. USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date |
string (YYYY-MM-DD) | optional |
Start of the date range. Defaults to 52 weeks ago.
e.g. 2025-01-01 |
end_date |
string (YYYY-MM-DD) | optional |
End of the date range. Defaults to today.
e.g. 2026-03-01 |
api_key |
string | required |
Professional API key.
e.g. YOUR_API_KEY |
Supported currencies
Response fields
| Field | Type | Description |
|---|---|---|
currency |
string | 3-letter currency code. |
instrument |
string | Full CFTC instrument name (e.g. JAPANESE YEN - CHICAGO MERCANTILE EXCHANGE). |
fx_overlay.pair |
string | Conventional spot pair label for chart overlays (e.g. USD/JPY, GBP/USD, DXY). |
start_date |
string | Start of the returned series (YYYY-MM-DD). |
end_date |
string | End of the returned series (YYYY-MM-DD). |
data[].date |
string | Tuesday as-of date for the COT snapshot (YYYY-MM-DD). |
data[].announcement_datetime |
integer | Unix timestamp of the Friday 3:30 PM ET CFTC publication for this row. |
data[].open_interest |
integer | Total open interest across all participants. |
data[].noncommercial_long |
integer | Non-commercial (speculative) long positions. |
data[].noncommercial_short |
integer | Non-commercial (speculative) short positions. |
data[].noncommercial_net |
integer | Net speculative positioning (long minus short). |
data[].noncommercial_spread |
integer | Non-commercial spread positions. |
data[].commercial_long |
integer | Commercial (hedger) long positions. |
data[].commercial_short |
integer | Commercial (hedger) short positions. |
data[].commercial_net |
integer | Net commercial positioning (long minus short). |
data[].total_reportable_long |
integer | Total reportable long positions. |
data[].total_reportable_short |
integer | Total reportable short positions. |
data[].nonreportable_long |
integer | Non-reportable (small trader) long positions. |
data[].nonreportable_short |
integer | Non-reportable (small trader) short positions. |
Example request
Returns USD COT history. All COT requests require a Professional API key. Data sourced from the CFTC Legacy Futures-Only report.
/api/v1/commodities/{indicator}
Pro key required
Precious metals price series for gold, silver, and platinum.
Always requires a Professional API key regardless of indicator.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
indicator |
string | required |
Commodity indicator slug.
e.g. gold, silver, platinum |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date |
string (YYYY-MM-DD) | optional |
Start of the date range. Defaults to 365 days ago.
e.g. 2025-01-01 |
end_date |
string (YYYY-MM-DD) | optional |
End of the date range. Defaults to today.
e.g. 2026-03-01 |
api_key |
string | required |
Professional API key.
e.g. YOUR_API_KEY |
Supported metals indicators (3)
| Slug | Name | Unit | Frequency |
|---|---|---|---|
gold |
Gold (LBMA PM Fix) | USD/troy oz | Daily |
silver |
Silver (LBMA Fix) | USD/troy oz | Daily |
platinum |
Platinum Spot | USD/troy oz | Daily |
Response fields
| Field | Type | Description |
|---|---|---|
currency |
string | Always COMM (commodity namespace). |
indicator |
string | Precious metals slug as requested (e.g. gold, silver, platinum). |
has_official_forecast |
boolean | Always false — precious metals have no official central bank forecast. |
start_date |
string | Earliest date in the returned series (YYYY-MM-DD). |
end_date |
string | Latest requested end date (YYYY-MM-DD). |
data[].date |
string | Observation date (YYYY-MM-DD). |
data[].val |
number | null | Price or index value in the indicator's native unit. |
data[].announcement_datetime |
integer | null | Unix timestamp of the official data publication (null for daily prices). |
data[].pct_change |
number | null | Period-over-period percentage change. |
data[].pct_change_12m |
number | null | 12-month rolling percentage change. |
Example request
Returns gold LBMA PM Fix daily spot prices for the past year. Replace gold with silver or platinum for the other supported metals.
Indicator coverage
Announcement endpoint index
Per-currency detail pages for every announcement indicator. USD endpoints are free; all others require a Professional subscription.
Kinh tế (29)
Tăng trưởng Tổng sản phẩm quốc nội (GDP)
gdp
Đo lường sự thay đổi hàng quý trong giá trị đã điều chỉnh lạm phát của tất cả hàng hóa và dịch vụ được sản xuất.
Tỷ lệ lạm phát (CPI/HICP)
inflation
Đo lường phần trăm thay đổi hàng năm của Chỉ số giá tiêu dùng (CPI).
Lạm phát cơ bản
core_inflation
CPI không bao gồm các mặt hàng dễ biến động như thực phẩm và năng lượng.
Chỉ số giá PCE
pce
Chỉ số giá Chi tiêu tiêu dùng cá nhân (PCE) chính được công bố bởi BEA.
Chỉ số giá sản xuất (PPI)
ppi
Đo lường sự thay đổi trung bình theo thời gian trong giá bán mà các nhà sản xuất trong nước nhận được cho sản phẩm của họ.
Cán cân thương mại
trade_balance
Sự khác biệt giữa giá trị xuất khẩu và nhập khẩu của một quốc gia.
Cán cân hàng hóa
balance_on_goods
Cán cân thanh toán: thương mại hàng hóa.
Cán cân dịch vụ
balance_on_services
Cán cân thanh toán: thương mại dịch vụ.
Xuất khẩu hàng hóa & dịch vụ
exports
Tổng kim ngạch xuất khẩu được báo cáo bởi ABS (triệu AUD), hàng quý dựa trên tài khoản quốc gia.
Nhập khẩu hàng hóa & dịch vụ
imports
Tổng kim ngạch nhập khẩu được báo cáo bởi ABS (triệu AUD), hàng quý dựa trên tài khoản quốc gia.
Cán cân vãng lai
current_account_balance
Đo lường thương mại hàng hóa và dịch vụ cùng với dòng thu nhập.
Doanh số bán lẻ
retail_sales
Đo lường sự thay đổi trong tổng giá trị doanh số bán hàng ở cấp độ bán lẻ.
Sản xuất công nghiệp
industrial_production
Đo lường sản lượng của khu vực công nghiệp (sản xuất, khai khoáng, tiện ích).
Đơn đặt hàng hóa lâu bền
durable_goods_orders
Đo lường các đơn đặt hàng mới được đặt với các nhà sản xuất trong nước để giao hàng hóa lâu bền.
Tâm lý người tiêu dùng
consumer_sentiment
Một cuộc khảo sát về mức độ tin cậy của người tiêu dùng.
Trade-Weighted Index (NEER)
trade_weighted_index
Nominal Effective Exchange Rate (NEER) measuring the value of a currency relative to a basket of trading partners'...
House Price Index
house_price_index
Measures changes in residential property prices over time, reflecting housing market conditions and consumer wealth.
Inflation MoM
inflation_mom
Month-over-month change in the consumer price index, measuring short-term inflationary momentum.
Producer Price Index MoM (PPI)
ppi_mom
Month-over-month change in producer prices, an early indicator of inflationary pressure in the supply chain.
Core Inflation MoM
core_inflation_mom
Month-over-month change in core consumer prices (excluding food and energy), tracking underlying inflation trends.
PCE MoM
pce_mom
Month-over-month change in the Personal Consumption Expenditures price index.
Building Permits
building_permits
Number of new residential construction permits authorized, a leading indicator of future housing activity and...
Housing Starts
housing_starts
Number of new residential construction projects that have begun in a given period, a key indicator of economic...
Government Debt
government_debt
Total outstanding debt obligations of the central government, indicating fiscal sustainability and public sector...
Manufacturing PMI
pmi
Purchasing Managers' Index for the manufacturing sector, a leading indicator of economic activity based on surveys...
Services PMI (NMI)
nmi
Non-Manufacturing Index (NMI) or Services PMI, a leading indicator of economic activity in the services sector. A...
Business Confidence
business_confidence
Survey-based measure of business executives' outlook on economic conditions, production, and investment plans.
Niềm tin người tiêu dùng
consumer_confidence
Chỉ số hàng đầu KOF / Chỉ số niềm tin tiêu dùng.
Thị trường Lao động (11)
Tỷ lệ thất nghiệp
unemployment
Tỷ lệ phần trăm lực lượng lao động thất nghiệp.
Việc làm toàn thời gian
full_time_employment
Số người làm việc toàn thời gian.
Việc làm bán thời gian
part_time_employment
Số người làm việc bán thời gian.
Tỷ lệ tham gia lực lượng lao động
participation_rate
Tỷ lệ lực lượng lao động so với dân số trong độ tuổi lao động.
Bảng lương phi nông nghiệp (NFP)
non_farm_payrolls
Số lượng lao động tại Hoa Kỳ không bao gồm lao động nông nghiệp.
Thu nhập bình quân hàng giờ
average_hourly_earnings
Đo lường sự thay đổi trong chi phí mà các doanh nghiệp trả cho lao động.
Số đơn xin trợ cấp thất nghiệp lần đầu
initial_jobless_claims
Số đơn yêu cầu trợ cấp thất nghiệp ban đầu hàng tuần.
Thu nhập/Tiền lương bình quân hàng tuần
wages
Đo lường tăng trưởng tiền lương danh nghĩa.
Job Openings
job_openings
Total number of unfilled job positions, a key indicator of labor market demand and tightness.
NAIRU (Natural Rate of Unemployment)
nairu
Non-Accelerating Inflation Rate of Unemployment — the estimated unemployment rate consistent with stable inflation,...
Tiền tệ & Tín dụng (10)
Tiền rộng (M3)
broad_money
Tổng cung tiền bao gồm tiền mặt, tiền gửi và các tài sản thanh khoản khác.
Tăng trưởng tín dụng
credit_growth
Tổng tăng trưởng tín dụng từ chuỗi dữ liệu của RBA.
Tiền hẹp (M1)
m1
Tiền tệ lưu thông + tiền gửi giao dịch. RBNZ cột A.
Cung tiền M2
m2
M1 + tiền gửi tiết kiệm (không kỳ hạn). RBNZ tính toán: cột A + B1.
Tiền rộng (M3)
m3
M1 + tiền gửi tiết kiệm + tiền gửi có kỳ hạn. RBNZ cột A+B (tổng hợp rộng nhất).
Tiền tệ lưu thông
money_supply_currency
Tiền tệ do công chúng nắm giữ. Thành phần phụ A1 của M1.
Tiền gửi giao dịch
money_supply_transaction_deposits
Tiền gửi không kỳ hạn. Thành phần phụ A2 của M1.
Tiền gửi tiết kiệm
money_supply_savings_deposits
Tiền gửi tiết kiệm không kỳ hạn. Thành phần gia tăng B1 của M2.
Tiền gửi có kỳ hạn
money_supply_term_deposits
Tiền gửi có kỳ hạn. Thành phần gia tăng B2 của M3.
Tổng tín dụng trong nước
domestic_credit
Tín dụng ròng cho chính phủ trung ương + tín dụng khu vực tư nhân. RBNZ cột C+D.
Chính sách Tiền tệ (5)
Lãi suất chính sách của Ngân hàng Trung ương
policy_rate
Lãi suất chính do Ngân hàng Trung ương đặt ra.
Lãi suất phi rủi ro
risk_free_rate
Lãi suất cho vay qua đêm giữa các ngân hàng.
Foreign Exchange Reserves
foreign_reserves
Assets held by the central bank in foreign currencies, used to support the exchange rate and manage monetary policy....
Gold Reserves
gold_reserves
Quantity of gold held by the central bank as part of its foreign exchange reserves, measured in value terms.
Lợi suất Trái phiếu Chính phủ (12)
Lợi suất trái phiếu chính phủ 1 năm
gov_bond_1y
Lợi suất trái phiếu chính phủ 4 năm
gov_bond_4y
Lợi suất trái phiếu chính phủ 40 năm
gov_bond_40y
Lãi suất (1)
Lãi suất tiền gửi qua đêm
deposit_rates
Lãi suất tiền gửi qua đêm tại các ngân hàng đã đăng ký. Lãi suất ngân hàng hàng ngày của RBNZ.
Các chỉ số của SNB (2)
Các chỉ số Bổ sung (22)
Triển vọng kinh doanh của BoC
boc_business_outlook
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Phê duyệt xây dựng
building_approvals
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Hàng hóa năng lượng
commodity_price_energy
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Hàng hóa phi năng lượng
commodity_price_ex_energy
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Chỉ số giá hàng hóa
commodity_price_index
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Giá hàng hóa
commodity_prices
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Kỳ vọng người tiêu dùng
consumer_expectations
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Lạm phát cơ bản (Trung vị)
core_inflation_median
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Lạm phát cơ bản (Cắt bỏ)
core_inflation_trim
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Dự trữ ngoại hối
fx_reserves
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
GDP hàng quý
gdp_quarterly
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Giá nhà
house_prices
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Tín dụng hộ gia đình
household_credit
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Kỳ vọng lạm phát
inflation_expectations
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
KOF Barometer
kof_barometer
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
CPI hàng tháng
monthly_cpi
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Lãi suất thế chấp
mortgage_rate
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Tỷ giá hối đoái thực
real_exchange_rate
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Tankan Capex
tankan_capex
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Tỷ lệ trao đổi thương mại
terms_of_trade
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Lạm phát trung bình cắt bỏ
trimmed_mean_inflation
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
Chỉ số giá tiền lương
wage_price_index
Chỉ số được xác thực bằng các bài kiểm tra tích hợp.
No indicators match your search.
API response structure
Representative payload snapshots
Example field values from the live production contract. Core timestamp semantics are consistent across families; each endpoint adds domain-specific fields on top.
Discovery
USD catalogue metadata
Indicator discovery is not limited to one headline series. The live USD catalogue currently includes growth, inflation, rates, labor, housing, liquidity, and reserve metrics.
/api/v1/data_catalogue/usd
Announcement Series
EUR inflation release data
Announcement series return a top-level envelope plus a data array of observations, each stamped with the exact publication timestamp used for event-driven research.
/api/v1/announcements/eur/inflation
COT Positioning
GBP speculative positioning
Weekly CFTC COT data tracks net speculative positioning by currency. Includes open interest, long/short splits for commercial, non-commercial, and non-reportable traders.
/api/v1/cot/gbp
Release Calendar
JPY upcoming releases
The calendar endpoint returns upcoming releases sorted by announcement timestamp. Non-announcement rows (e.g. COT) include routing metadata like endpoint_path.
/api/v1/calendar/jpy
Metals
Gold LBMA PM Fix prices
Precious metals series return daily price data from official sources with period-over-period and 12-month change enrichment.
/api/v1/commodities/gold
Market Sessions
Live FX session snapshot
The market sessions endpoint returns real-time open/close state for Sydney, Tokyo, London, and New York, plus overlap windows showing peak-liquidity periods.
/api/v1/market_sessions
Schema and connectors
OpenAPI schema and MCP reference
The production OpenAPI schema is the authoritative path list. The MCP reference covers remote AI tooling and OAuth connector behavior.