Wie man FXMacroData Endpunkte und Authentifizierung verwendet

Am Ende dieses Handbuchs können Sie sich korrekt authentifizieren, die richtige Endpunktfamilie für jede Aufgabe auswählen und Produktionsanfragen über die FXMacroData API ausführen, ohne die Routenstruktur oder die Indikatordeckung zu erraten.

Schritt 1 - Beginnen Sie mit der URL der Produktionsbasis

Alle öffentlichen Beispiele sollten von der Produktions-API-Basis ausgehen:

https://fxmacrodata.com/api/v1

Die Endpunktfamilien, die Sie am häufigsten verwenden, sind:

• /announcements/{currency}/{indicator} für historische freigegebene Werte mit präziser announcement_datetime
• /calendar/{currency} für bevorstehende Zeitstempel
• /catalogue/{currency} für die Entdeckbarkeit unterstützter Indikatoren
• /cot/{currency} für die Anlage von Anlegerverpflichtungen
• /commodities/{indicator} für Rohstoff- und Energieerzeugnisreihen
• /forex/{pair} Und ... /market-sessions für den Marktkontext

Schritt 2 - Richtige Authentifizierung mit Abfrageparametern

FXMacroData verwendet die Authentifizierung durch Abfrageparameter in öffentlichen Anwendungsbeispielen:

?api_key=YOUR_API_KEY

Der Zugang zu USD-Endpunkten ist ohne Schlüssel verfügbar, während für nicht USD-Route ein gültiger Schlüssel erforderlich ist.

# USD endpoint (no key required)
curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation"

# Non-USD endpoint (key required)
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"

Schritt 3 - Entdecken Sie, was vor der Codierung verfügbar ist

Wenn Sie nicht sicher sind, welche Indikatoren für eine Währung vorhanden sind, rufen Sie zuerst die Katalogroute an.

curl "https://fxmacrodata.com/api/v1/catalogue/eur?api_key=YOUR_API_KEY"

Dann benutzen Sie den Index der Indikatorenseite in der Dokumentationsindikatorindex Die Daten werden in einem anderen Modul übermittelt.

Schritt 4 - Ausgabe von Daten aus den Endpunkten der Ankündigungen

Ankündigungsendpunkte geben ein oberstes Objekt plus a zurück . data Jede Zeile enthält ein Periodenende date- Ich weiß . valUnd ein announcement_datetime Zeitstempel.

curl "https://fxmacrodata.com/api/v1/announcements/gbp/unemployment?api_key=YOUR_API_KEY"

{
  "currency": "GBP",
  "indicator": "unemployment",
  "has_official_forecast": false,
  "start_date": "2025-01-31",
  "end_date": "2026-03-31",
  "data": [
    {
      "date": "2026-01-31",
      "val": 4.39,
      "announcement_datetime": 1770521400
    }
  ]
}

Für genaue Indikatorsemantik und -Einheiten, überprüfen Sie die Endpunkteiten wie Kurs der USD Und ... Inflation im Euro- Ich weiß .

Schritt 5 - Verwenden Sie den Release-Kalender für ereignisgesteuerte Arbeitsabläufe

Der Release-Kalender hilft Ihnen, die Abholungen um die Veröffentlichungszeit zu planen, anstatt ständig zu wählen.

curl "https://fxmacrodata.com/api/v1/calendar/usd?indicator=non_farm_payrolls"

Ein robustes Muster ist: Abfrage-Kalender -> lesen Sie als Nächstes announcement_datetime -> holen Sie die passenden Ankündigungen Route zum Zeitpunkt der Veröffentlichung.

Schritt 6 - Zusätzliche Endpunktfamilien hinzufügen

Sobald Ihr Kern-Ankündigungsfluss stabil ist, erweitern Sie die Abdeckung mit domänenspezifischen Routen:

• Die Bezeichnung des Erzeugnisses ist: /api/v1/cot/{currency} für den Kontext der Futures-Positionierung
• Metalle: /api/v1/commodities/{indicator} für Gold, Silber, Platin und verwandte Safe-Haven-Inputs
• Forex: /api/v1/forex/{pair} für die Spot-Ausrichtung mit Makro-Releases
• Marktveranstaltungen: /api/v1/market-sessions für die automatische Bedienung der Sitzung

curl "https://fxmacrodata.com/api/v1/cot/usd"
curl "https://fxmacrodata.com/api/v1/commodities/gold"
curl "https://fxmacrodata.com/api/v1/forex/eurusd"
curl "https://fxmacrodata.com/api/v1/market-sessions"

Schritt 7 - Beispiel für End-to-End Python

Das folgende Snippet überprüft die Verfügbarkeit, holt eine Indikatorreihe ab und gibt den letzten Druck zurück.

import requests

BASE = "https://fxmacrodata.com/api/v1"
API_KEY = "YOUR_API_KEY"


def fetch_latest(currency: str, indicator: str, api_key: str | None = None) -> dict | None:
    params = {}
    if api_key:
        params["api_key"] = api_key

    catalogue = requests.get(f"{BASE}/catalogue/{currency}", params=params, timeout=10)
    catalogue.raise_for_status()

    endpoint = requests.get(
        f"{BASE}/announcements/{currency}/{indicator}",
        params=params,
        timeout=10,
    )
    endpoint.raise_for_status()

    rows = endpoint.json().get("data", [])
    return rows[-1] if rows else None


latest = fetch_latest("aud", "policy_rate", API_KEY)
print(latest)

Was Sie als nächstes bauen können

Sie haben nun den vollen Weg zur Authentifizierung, Ermittlung der Abdeckung, Anforderung historischer Release-Serien und Erweiterung in die kalendergesteuerte Automatisierung. Wie man die Release-Kalender-API verwendet So reagiert Ihr System genau, wenn neue Makrodaten veröffentlicht werden.