Low-latency reads

Currency and indicator slugs are the same as on the history endpoints; the data catalogue lists them. An unknown slug returns 404 with the supported values.

When free access holds back every stored print, the response still answers 200 and freemium_delay.withheld_count tells you how many rows are waiting and when the next one becomes available. See free access.

{
  "currency": "USD",
  "indicator": "inflation",
  "source": "U.S. Bureau of Labor Statistics",
  "provenance": { "publisher": "...", "storage": "...", "served_by": "...", "timestamp_field": "announcement_datetime", "value_field": "val" },
  "data_quality": { "quality_scope": "latest", "point_in_time_safe": true, "latest_available_date": "2026-08-31", "...": "..." },
  "data": {
    "date": "2026-08-31",
    "val": 2.9,
    "announcement_datetime": 1757512800,
    "publication_time_status": "confirmed",
    "release_timing": { "published_by": "2026-09-10T12:30:00.412Z", "available_at": "2026-09-10T12:30:00.9031Z", "pickup_ms_max": 491.0, "...": "..." },
    "...": "..."
  }
}

• recent adds count and returns data as an array ordered most recent first.
• data_quality.quality_scope is latest or recent, so the quality counters describe exactly the rows returned.
• freemium_delay is present only when free access withheld a newer print.
• A series with nothing stored yet returns 503 rather than an empty row.

1. Receive the event. A webhook, SSE or WebSocket event, or a poll of /v1/announcements/changes, tells you a release for a currency and indicator has landed.
2. Read the row. Call /v1/latest/announcements/{currency}/{indicator} for the full row, including release_timing and provenance.
3. Fetch history when you need it. Use /v1/announcements/{currency}/{indicator} with a window, selectors or revisions=all for anything beyond the newest rows.

Newest USD inflation print, no key:

curl "https://api.fxmacrodata.com/v1/latest/announcements/usd/inflation"

Three most recent ECB policy-rate decisions:

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.fxmacrodata.com/v1/recent/announcements/eur/policy_rate?limit=3"

Newest COT report for the euro, and the newest gold observation:

curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/latest/cot/eur"
curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/latest/commodities/gold"

Python, reacting to a release event:

import requests

API = "https://api.fxmacrodata.com"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}

def on_release(event):
    currency = event["currency"].lower()
    indicator = event["indicator"]
    row = requests.get(
        f"{API}/v1/latest/announcements/{currency}/{indicator}",
        headers=HEADERS,
        timeout=10,
    ).json()["data"]
    print(row["date"], row["val"], row["publication_time_status"])