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.

OpenAPI Schema MCP Docs Changelog

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 for last 365 days)

Announcements are mixed-access: USD is public for the most recent 365 days, while non-USD currencies and the full USD history 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.

00
How-To Guide
Authentication walkthroughs & usage patterns
 01
Performance
Compression, ETag caching & pagination
 01
Macro data and discovery
Fetch normalized macroeconomic indicator series with announcement...
 02
FX market structure and sentiment
Query spot FX pairs and inspect the live global trading-session...
 03
Market positioning and metals
CFTC Commitment of Traders positioning by currency and precious...
Indicator Index
Per-currency detail pages, filterable by indicator
Response Schemas
Representative payload snapshots per endpoint family
App Gallery
Dash, Vercel, Streamlit, and more build templates

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.

Open how-to article Browse all how-to guides

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

Performance & efficiency

Compression, caching, and pagination

Every public read endpoint supports response compression, conditional revalidation, and opt-in pagination. Using these features cuts bandwidth and request latency without changing the JSON response shape.

1 · Gzip compression

Always on for clients that ask for it.

Send Accept-Encoding: gzip on requests. JSON time-series payloads typically compress 8–12×. Browsers, curl, requests, and most HTTP clients negotiate this automatically.

curl -H "Accept-Encoding: gzip" \
  --compressed \
  https://fxmacrodata.com/api/v1/announcements/usd/inflation

2 · ETag & Cache-Control

Re-poll for free with conditional GETs.

Every cacheable response carries an ETag and a Cache-Control header. Re-send the ETag in If-None-Match on the next poll — if data hasn't changed, you get an empty 304 Not Modified with no body, no Firestore read, and no egress.

If-None-Match: W/"usd-inflation-v42"
→ HTTP/1.1 304 Not Modified

3 · Pagination

Optional limit & offset.

On /v1/announcements/{ccy}/{ind} and /v1/predictions/{ccy}, pass limit (1–10000) and optional offset to slice data[]. Rows are most-recent-first; omit both for full-window results (default behaviour, unchanged).

/v1/announcements/usd/inflation?limit=10
/v1/predictions/eur?limit=20&offset=20

Cache-Control by endpoint family

FamilyAnonymousAuthenticated
/v1/announcements/*
/v1/predictions/*		public, max-age=10, swr=60private, no-store
/v1/calendar/*
/v1/cot/*
/v1/forex/*		public, max-age=60, stale-while-revalidate=300
/v1/catalogue
/v1/market_sessions/*		public, max-age=60, stale-while-revalidate=300

Single-indicator announcements & predictions use a version-keyed ETag (W/"{ccy}-{ind}-v{N}") that bumps on every successful ingest, so revalidation is essentially free at the origin.

Practical request example (Python)

import requests

s = requests.Session()
s.headers["Accept-Encoding"] = "gzip"

# First call: full body, ETag in headers
r1 = s.get(
    "https://fxmacrodata.com/api/v1/announcements/usd/inflation",
    params={"limit": 50},
)
etag = r1.headers["ETag"]

# Next poll: conditional GET, returns 304 if unchanged
r2 = s.get(
    "https://fxmacrodata.com/api/v1/announcements/usd/inflation",
    params={"limit": 50},
    headers={"If-None-Match": etag},
)
print(r2.status_code)  # 304 when nothing has been re-ingested

Operational guardrails

Rate limits & fair use

Rate limits apply only to authenticated requests. Anonymous traffic (no API key) is not rate-limited — we don't throttle by IP, so shared-infrastructure callers (Googlebot, ChatGPT, residential CDNs, corporate proxies) won't hit 429s just because many end users share one address. Per-key tiered budgets keep one identified client from saturating a Cloud Run instance and degrading service for everyone else. Pro and Enterprise are sized so normal production workloads — including dashboards, scheduled jobs, and live trading systems — never trip them.

Tier limits

Tier Requests / minute Requests / hour Requests / day Concurrent in-flight Per-endpoint / second
Anonymous (no key) no limit no limit no limit no limit no limit
Free 30 300 2,000 5 1
Pro / Startup 300 5,000 100,000 20 no cap
Enterprise 3,000 50,000 500,000 100 no cap

Admin keys and explicit partner allowlists bypass all checks. Limits are global per API key — calls to /announcements, /calendar, /forex, etc. all draw from the same minute/hour/day pool. Anonymous traffic carries no X-RateLimit-* headers because no per-request budget is tracked.

429 response shape

HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Window: minute

{"detail": "Rate limit exceeded (minute). Maximum 30 requests per 60s. See https://fxmacrodata.com/documentation/#rate-limits"}

Response headers (every request)

  • X-RateLimit-Limit — budget for the binding window (or bypassed / unlimited).
  • X-RateLimit-Remaining — remaining slots in that window. Throttle when this trends toward zero.
  • X-RateLimit-Window — on 429, identifies which budget tripped: minute, hour, day, endpoint, or concurrency.
  • Retry-After — seconds until the offending window resets (429 only).

Best practices

  • Use conditional requests. Send If-None-Match with the last ETag — 304 responses don't count against your endpoint cap and use ~5% of the bandwidth of a fresh payload.
  • Avoid wide fanouts on a single key. If you need to poll many endpoints in parallel, stay well under the concurrency cap (the binding constraint for bots that hit dozens of routes at once).
  • Use ?limit=. Most endpoints accept a limit query parameter so you only pull the rows you actually need.
  • Stream live announcements via SSE. For real-time use cases, subscribe to the streaming endpoint instead of polling.
  • Need higher headroom? Email info@fxmacrodata.com and we'll size an Enterprise plan to your workload.

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.

GET /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
NameTypeRequiredDescription
currency string required 3-letter currency code.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd, sgd, sek, dkk, pln, brl, hkd, nok
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
NameTypeRequiredDescription
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 and for USD requests that need history older than 365 days.
e.g. YOUR_API_KEY
Response fields
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/announcements/usd/inflation

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. Forecasts are served separately by /v1/predictions/{currency}; join via `announcement_id`.

Supported currencies (18)
USD EUR GBP JPY AUD CAD CHF NZD SGD SEK DKK PLN HKD NOK THB TWD TRY BRL
GET /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
NameTypeRequiredDescription
currency string required 3-letter currency code.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd
Query parameters
NameTypeRequiredDescription
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 and for USD requests that need history older than 365 days.
e.g. YOUR_API_KEY
Response fields
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/predictions/usd?indicator=inflation

Use the announcement_id to join each prediction with the realised observation returned by /v1/announcements/{currency}/{indicator}.

Supported currencies (18)
USD EUR GBP JPY AUD CAD CHF NZD SGD SEK DKK PLN HKD NOK THB TWD TRY BRL
GET /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
NameTypeRequiredDescription
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
NameTypeRequiredDescription
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 and for USD requests that need history older than 365 days.
e.g. YOUR_API_KEY
Response fields
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/predictions/usd/inflation?prediction_source=philly_fed_spf

Join predictions to actuals via the announcement_id field shared with /v1/announcements/{currency}/{indicator}.

Supported currencies (18)
USD EUR GBP JPY AUD CAD CHF NZD SGD SEK DKK PLN HKD NOK THB TWD TRY BRL
GET /api/v1/calendar/{currency} Free

Upcoming release dates for a currency and optional indicator filter.

Fully public — no API key required.

Path parameters
NameTypeRequiredDescription
currency string required 3-letter currency code or COMM for commodity release schedules.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd, sgd, sek, dkk, pln, brl, hkd, nok, COMM
Query parameters
NameTypeRequiredDescription
indicator string optional Optional filter to a specific indicator slug (e.g. inflation, gdp).
e.g. inflation, gdp, unemployment
Response fields
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/calendar/usd

Returns all upcoming USD macro release dates. Filter by indicator with ?indicator=inflation.

Supported currencies (19)
USD EUR GBP JPY AUD CAD CHF NZD SGD SEK DKK PLN HKD NOK THB TWD TRY BRL COMM
GET /api/v1/data_catalogue/{currency} Free

Available indicator metadata for a currency.

Fully public — no API key required.

Path parameters
NameTypeRequiredDescription
currency string required 3-letter currency code.
e.g. usd, eur, gbp, jpy, aud, cad, chf, nzd
Query parameters
NameTypeRequiredDescription
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
FieldTypeDescription
{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

GET https://fxmacrodata.com/api/v1/data_catalogue/usd

Lists all indicators available for USD with name, unit, and frequency metadata.

Supported currencies (18)
USD EUR GBP JPY AUD CAD CHF NZD SGD SEK DKK PLN HKD NOK THB TWD TRY BRL

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.

GET /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
NameTypeRequiredDescription
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
NameTypeRequiredDescription
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
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/forex/eur/usd

Returns daily EUR/USD spot rates for the past year.

Supported currencies (18)
USD EUR GBP JPY AUD CAD CHF NZD SGD SEK DKK PLN HKD NOK THB TWD TRY BRL
GET /api/v1/market_sessions Free

Real-time FX market-session and overlap timetable.

Fully public — no API key required.

Query parameters
NameTypeRequiredDescription
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
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/market_sessions

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.

GET /api/v1/cot/{currency} Pro key required

Weekly CFTC Commitment of Traders positioning by currency.

Always requires a Professional API key.

Path parameters
NameTypeRequiredDescription
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
NameTypeRequiredDescription
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

USD EUR GBP JPY AUD CAD CHF NZD TRY
Response fields
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/cot/usd?api_key=YOUR_API_KEY

Returns USD COT history. All COT requests require a Professional API key. Data sourced from the CFTC Legacy Futures-Only report.

GET /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
NameTypeRequiredDescription
indicator string required Commodity indicator slug.
e.g. gold, silver, platinum
Query parameters
NameTypeRequiredDescription
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)
SlugNameUnitFrequency
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
FieldTypeDescription
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

GET https://fxmacrodata.com/api/v1/commodities/gold?api_key=YOUR_API_KEY

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.

Économie (29)

Croissance du Produit Intérieur Brut (GDP)

gdp

Mesure la variation trimestrielle de la valeur ajustée à l'inflation de tous les biens et services produits.

USD AUD GBP CHF NZD EUR JPY BRL

Taux d'inflation (CPI/HICP)

inflation

Mesure la variation en pourcentage d'une année sur l'autre de l'Indice des Prix à la Consommation (CPI).

USD AUD GBP CHF NZD EUR JPY BRL

Inflation sous-jacente

core_inflation

CPI excluant les éléments volatils comme l'alimentation et l'énergie.

USD CHF GBP AUD CAD EUR JPY NZD

Indice des prix PCE

pce

L'indice des prix des dépenses de consommation personnelle (PCE) publié par le BEA.

USD

Indice des prix à la production (PPI)

ppi

Mesure la variation moyenne au fil du temps des prix de vente reçus par les producteurs nationaux pour leur production.

GBP USD CHF JPY AUD CAD EUR NZD

Balance commerciale

trade_balance

La différence entre la valeur des exportations et des importations d'un pays.

AUD EUR GBP USD CHF JPY NZD BRL

Balance des biens

balance_on_goods

Balance des paiements : échanges de biens.

EUR

Balance des services

balance_on_services

Balance des paiements : échanges de services.

EUR

Exportations de biens et services

exports

Exportations totales déclarées par l'ABS (millions d'AUD), trimestriellement basées sur les comptes nationaux.

AUD CHF GBP

Importations de biens et services

imports

Importations totales déclarées par l'ABS (millions d'AUD), trimestriellement basées sur les comptes nationaux.

AUD CHF GBP

Balance des opérations courantes

current_account_balance

Mesure les échanges de biens et services et les flux de revenus.

EUR GBP USD AUD CHF JPY NZD BRL

Ventes au détail

retail_sales

Mesure la variation de la valeur totale des ventes au détail.

GBP USD AUD CAD CHF JPY

Production industrielle

industrial_production

Mesure la production du secteur industriel (manufacture, mines, services publics).

USD

Commandes de biens durables

durable_goods_orders

Mesure les nouvelles commandes passées auprès des fabricants nationaux pour la livraison de biens durables.

USD

Sentiment des consommateurs

consumer_sentiment

Une enquête sur les niveaux de confiance des consommateurs.

USD CAD CHF JPY

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'...

AUD BRL CAD CHF DKK EUR GBP JPY

House Price Index

house_price_index

Measures changes in residential property prices over time, reflecting housing market conditions and consumer wealth.

AUD USD

Inflation MoM

inflation_mom

Month-over-month change in the consumer price index, measuring short-term inflationary momentum.

CAD EUR GBP USD DKK PLN

Producer Price Index MoM (PPI)

ppi_mom

Month-over-month change in producer prices, an early indicator of inflationary pressure in the supply chain.

EUR USD

Core Inflation MoM

core_inflation_mom

Month-over-month change in core consumer prices (excluding food and energy), tracking underlying inflation trends.

EUR USD

PCE MoM

pce_mom

Month-over-month change in the Personal Consumption Expenditures price index.

USD

Building Permits

building_permits

Number of new residential construction permits authorized, a leading indicator of future housing activity and...

CAD USD

Housing Starts

housing_starts

Number of new residential construction projects that have begun in a given period, a key indicator of economic...

CAD JPY USD

Government Debt

government_debt

Total outstanding debt obligations of the central government, indicating fiscal sustainability and public sector...

USD

Manufacturing PMI

pmi

Purchasing Managers' Index for the manufacturing sector, a leading indicator of economic activity based on surveys...

USD

Services PMI (NMI)

nmi

Non-Manufacturing Index (NMI) or Services PMI, a leading indicator of economic activity in the services sector. A...

USD

Business Confidence

business_confidence

Survey-based measure of business executives' outlook on economic conditions, production, and investment plans.

CAD

Confiance des consommateurs

consumer_confidence

Indicateur avancé KOF / Indice de confiance des consommateurs.

CAD CHF JPY

Business Sentiment

business_sentiment

Survey-based measure of business sentiment reflecting executive expectations for production, orders, and overall...

CAD CHF USD

Marché du travail (11)

Taux de chômage

unemployment

Pourcentage de la population active au chômage.

AUD GBP USD NZD CHF EUR JPY BRL

Niveau d'emploi

employment

Nombre total de personnes employées.

AUD CHF GBP USD NZD EUR JPY CAD

Emploi à temps plein

full_time_employment

Nombre de personnes employées à temps plein.

AUD CHF USD EUR GBP JPY NZD CAD

Emploi à temps partiel

part_time_employment

Nombre de personnes employées à temps partiel.

AUD CHF USD EUR GBP JPY NZD CAD

Taux de participation à la population active

participation_rate

Ratio de la population active par rapport à la population en âge de travailler.

AUD GBP USD NZD EUR JPY CHF CAD

Créations d'emplois non agricoles (NFP)

non_farm_payrolls

Nombre de travailleurs aux États-Unis, hors travailleurs agricoles.

USD

Salaires horaires moyens

average_hourly_earnings

Mesure la variation du prix que les entreprises paient pour la main-d'œuvre.

USD

Nouvelles demandes d'allocations chômage

initial_jobless_claims

Demandes hebdomadaires initiales d'allocations de chômage.

USD

Salaires hebdomadaires moyens / Salaires

wages

Mesure la croissance nominale des salaires.

AUD

Job Openings

job_openings

Total number of unfilled job positions, a key indicator of labor market demand and tightness.

USD

NAIRU (Natural Rate of Unemployment)

nairu

Non-Accelerating Inflation Rate of Unemployment — the estimated unemployment rate consistent with stable inflation,...

USD

Monnaie et crédit (10)

Masse monétaire au sens large (M3)

broad_money

Masse monétaire totale incluant les espèces, les dépôts et autres actifs liquides.

AUD GBP CHF

Croissance du crédit

credit_growth

Croissance totale du crédit de la série RBA.

AUD

Masse monétaire au sens étroit (M1)

m1

Monnaie en circulation + dépôts de transaction. RBNZ colonne A.

NZD CHF AUD BRL CAD EUR JPY USD

Masse monétaire M2

m2

M1 + dépôts d'épargne (à vue). RBNZ dérivé : colonne A + B1.

NZD CHF BRL CAD EUR JPY USD AUD

Masse monétaire au sens large (M3)

m3

M1 + épargne + dépôts à terme. RBNZ colonne A+B (agrégat le plus large).

NZD AUD BRL CAD CHF EUR JPY GBP

Monnaie en circulation

money_supply_currency

Monnaie détenue par le public. Sous-composante M1 A1.

NZD

Dépôts à vue

money_supply_transaction_deposits

Dépôts à vue. Sous-composante M1 A2.

NZD

Dépôts d'épargne

money_supply_savings_deposits

Dépôts d'épargne à vue. Composante incrémentale M2 B1.

NZD

Dépôts à terme

money_supply_term_deposits

Dépôts à terme fixe. Composante incrémentale M3 B2.

NZD

Crédit intérieur total

domestic_credit

Crédit net au gouvernement central + crédit au secteur privé. RBNZ colonne C+D.

NZD

Politique monétaire (5)

Taux directeur de la banque centrale

policy_rate

Taux d'intérêt directeur fixé par la Banque Centrale.

AUD EUR GBP JPY NZD USD CHF BRL

Taux sans risque

risk_free_rate

Taux de prêt interbancaire au jour le jour.

AUD CHF EUR GBP JPY NZD USD BRL

Foreign Exchange Reserves

foreign_reserves

Assets held by the central bank in foreign currencies, used to support the exchange rate and manage monetary policy....

AUD CHF JPY USD

Gold Reserves

gold_reserves

Quantity of gold held by the central bank as part of its foreign exchange reserves, measured in value terms.

AUD CHF USD

Central Bank Total Assets

cb_assets

Total assets on the central bank's balance sheet, reflecting the scale of monetary policy operations including...

AUD CHF JPY USD

Rendements des obligations d'État (12)

Rendement des obligations d'État à 1 an

gov_bond_1y
CHF

Rendement des obligations d'État à 2 ans

gov_bond_2y
AUD CHF EUR JPY NZD USD GBP SEK

Rendement des obligations d'État à 3 ans

gov_bond_3y
AUD CHF EUR JPY NZD USD GBP CAD

Rendement des obligations d'État à 4 ans

gov_bond_4y
CHF

Rendement des obligations d'État à 5 ans

gov_bond_5y
AUD CHF EUR GBP JPY NZD USD SEK

Rendement des obligations d'État à 7 ans

gov_bond_7y
JPY CAD

Rendement des obligations d'État à 10 ans

gov_bond_10y
AUD CHF EUR GBP JPY NZD USD DKK

Rendement des obligations d'État à 20 ans

gov_bond_20y
CHF JPY GBP

Rendement des obligations d'État à 30 ans

gov_bond_30y
CHF JPY CAD

Rendement des obligations d'État à 40 ans

gov_bond_40y
JPY

Rendement des obligations indexées sur l'inflation

inflation_linked_bond
AUD GBP NZD USD EUR CAD

Taux d'inflation implicite à 10 ans

breakeven_inflation_rate
USD EUR

Taux d'intérêt (1)

Taux de dépôt au jour le jour

deposit_rates

Taux de dépôt au jour le jour des banques enregistrées. Taux bancaires quotidiens de la RBNZ.

NZD

Indicateurs de la SNB (2)

Dépôts à vue

sight_deposits

Dépôts à vue de la SNB (soldes Girokonto).

CHF

Bilan de la SNB

snb_balance_sheet

Actifs totaux du bilan de la SNB.

CHF

Indicateurs supplémentaires (22)

Perspectives commerciales de la BoC

boc_business_outlook

Indicateur validé par des tests d'intégration.

CAD

Permis de construire

building_approvals

Indicateur validé par des tests d'intégration.

AUD

Matières premières énergétiques

commodity_price_energy

Indicateur validé par des tests d'intégration.

CAD

Matières premières hors énergie

commodity_price_ex_energy

Indicateur validé par des tests d'intégration.

CAD

Indice des prix des matières premières

commodity_price_index

Indicateur validé par des tests d'intégration.

CAD

Prix des matières premières

commodity_prices

Indicateur validé par des tests d'intégration.

AUD

Attentes des consommateurs

consumer_expectations

Indicateur validé par des tests d'intégration.

CAD

Inflation sous-jacente (médiane)

core_inflation_median

Indicateur validé par des tests d'intégration.

CAD

Inflation sous-jacente (moyenne tronquée)

core_inflation_trim

Indicateur validé par des tests d'intégration.

CAD

Réserves de change

fx_reserves

Indicateur validé par des tests d'intégration.

CHF

GDP trimestriel

gdp_quarterly

Indicateur validé par des tests d'intégration.

CAD

Prix des logements

house_prices

Indicateur validé par des tests d'intégration.

DKK

Crédit aux ménages

household_credit

Indicateur validé par des tests d'intégration.

CAD

Attentes d'inflation

inflation_expectations

Indicateur validé par des tests d'intégration.

AUD CHF

Baromètre KOF

kof_barometer

Indicateur validé par des tests d'intégration.

CHF

CPI mensuel

monthly_cpi

Indicateur validé par des tests d'intégration.

AUD

Taux hypothécaire

mortgage_rate

Indicateur validé par des tests d'intégration.

AUD

Taux de change réel

real_exchange_rate

Indicateur validé par des tests d'intégration.

AUD

Tankan Capex

tankan_capex

Indicateur validé par des tests d'intégration.

JPY

Termes de l'échange

terms_of_trade

Indicateur validé par des tests d'intégration.

AUD

Inflation à moyenne tronquée

trimmed_mean_inflation

Indicateur validé par des tests d'intégration.

AUD

Indice des prix des salaires

wage_price_index

Indicateur validé par des tests d'intégration.

AUD

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
gdp GDP · %QoQ · Quarterly
inflation Inflation CPI · %YoY · Monthly
policy_rate Policy Rate · % · Meeting

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
currency EUR
indicator inflation
has_official_forecast false
data[0].date 2026-02-28
data[0].val 2.3
data[0].announcement_datetime 1772272800

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
currency GBP
instrument BRITISH POUND - CME
fx_overlay.pair GBP/USD
data[0].date 2026-02-24
data[0].open_interest 245,678
data[0].noncommercial_net -8,020

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
currency JPY
data[0].release policy_rate
data[0].announcement_datetime 1774580400
data[1].endpoint_family cot
data[1].endpoint_path /v1/cot/jpy
data[1].requires_api_key true

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
currency COMM
indicator gold
data[0].date 2026-02-28
data[0].val 2870.00
data[0].pct_change 1.2
data[0].pct_change_12m 30.1

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
is_market_day true
sessions[0].name London
sessions[0].is_open true
sessions[0].seconds_to_close 18000
overlaps[0].name London / New York
overlaps[0].priority high

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.

OpenAPI schema MCP docs Indicator index ↑

Endpoint families

Macro data and discovery FX market structure and sentiment Market positioning and metals