Einführung des aktuellsten Endpunkts der Währung: Ein Anruf für den vollständigen Makro-Schnappschuss

Das Scannen des Makrostaates einer Währung bedeutete früher, für jeden Indikator einen separaten API-Aufruf zu erstellen einen für Inflation, einen für Arbeitslosigkeit, einen zum Leitzins usw. Ab heute können Sie den neuesten Wert, den vorherigen Druck und die Veränderung des Prozentsatzes für jeden Indizanten in einer einzigen authentifizierten Anfrage abrufen. Das gleiche Ein-Ausruf-Muster ist jetzt für die COT-Positionierung und die Rohstoffpreise verfügbar.

Was gibt's Neues?

Drei neue . /latest Die Aggregatendpunkte werden in der FXMacroData API live eingesetzt:

Jede Antwort beinhaltet eine Top-Level-Anfrage . as_of Die Daten werden in der Datenbank mit einem Datenwert verglichen, der sich aus dem jüngsten Indikator des Datensatzes ableitet, sodass Sie die Datenwährung immer kennen, ohne einzelne Zeilen zu analysieren.

• Anzeige Kanonische Schlacke, die dem Endpunkt der Ankündigungen entspricht
• Einheit Und ... Häufigkeit aus dem Datenkatalog, so dass Sie Werte ohne zweite Suche korrekt formatieren können
• zuletzt Ich bin nicht hier . date- Ich weiß . valUnd ... announcement_datetime der jüngsten Ausgabe
• vorherige die vorhergehende Beobachtung in den gleichen Bereichen
• Die Daten sind nicht mehr verfügbar. vorbereitete prozentuale Veränderung von vorher auf zuletzt, auf zwei Dezimalstellen gerundet

Für COT-Daten: pct_diff_prev ist eine Karte und nicht ein Skalar eine prozentuale Veränderung pro numerischem Positionierungsfeld (offene Zinsen, nichtkommerzielle Long- und Shortpositionen, Nettopositionen usw.) weil der vollständige COT-Snapshot mehrdimensional ist.

Warum es für Händler wichtig ist

Wenn Ihr System sieben Währungen etwa USD, EUR, GBP, AUD, JPY, CAD und CHF mit je zehn bis fünfzehn Indikatoren überwacht, kann eine naive Umfrage-Schleife mehr als hundert einzelne API-Aufrufe erfordern, um ein Dashboard zu aktualisieren oder ein Modell zu speisen.

Die ... /latest Endpunkte aus dem Firestore-Annonce-Storage gelesen die gleichen Daten, die die gesamte historische Reihe unterstützen so dass es keinen separaten Cache oder Verzögerung durch den aggregierten Aufruf eingeführt. Die Daten, welche Sie zurück erhalten, sind identisch mit der Abfrage jedes Indikators einzeln.

Praktisches Beispiel: USD Makro-Schnappschuss

Sie beobachten das US-Makrobild vor der New Yorker Open. /latest Endpunkt gibt den aktuellen Zustand jedes verfolgten Indikators mit dem vorherigen Druck und der Veränderung zwischen ihnen zurück:

curl "https://fxmacrodata.com/api/v1/announcements/usd/latest?api_key=YOUR_API_KEY"

Repräsentative Antwort (verknüpft auf drei Indikatoren):

{
  "currency": "USD",
  "source": "store",
  "as_of": "2026-03-31",
  "count": 14,
  "data": [
    {
      "indicator": "inflation",
      "unit": "%",
      "frequency": "Monthly",
      "has_official_forecast": false,
      "latest": {
        "date": "2026-02-28",
        "val": 2.8,
        "announcement_datetime": 1772433000
      },
      "previous": {
        "date": "2026-01-31",
        "val": 2.9,
        "announcement_datetime": 1769754600
      },
      "pct_diff_prev": -3.45
    },
    {
      "indicator": "non_farm_payrolls",
      "unit": "Persons",
      "frequency": "Monthly",
      "has_official_forecast": false,
      "latest": {
        "date": "2026-03-31",
        "val": 228000,
        "announcement_datetime": 1774857000
      },
      "previous": {
        "date": "2026-02-28",
        "val": 151000,
        "announcement_datetime": 1772256600
      },
      "pct_diff_prev": 50.99
    },
    {
      "indicator": "unemployment",
      "unit": "%",
      "frequency": "Monthly",
      "has_official_forecast": false,
      "latest": {
        "date": "2026-03-31",
        "val": 4.1,
        "announcement_datetime": 1774857000
      },
      "previous": {
        "date": "2026-02-28",
        "val": 4.1,
        "announcement_datetime": 1772256600
      },
      "pct_diff_prev": 0.0
    }
  ]
}

Aus dieser einzigen Antwort kann ein Händler oder Modell sofort die Überschrift lesen USD-Inflation Die Zahl der Arbeitnehmer in der Landwirtschaft stieg im Vergleich zum Vormonat leicht, während die Zahl der nicht landwirtschaftlichen Arbeitnehmer deutlich gestiegen ist. Arbeitslosenquote Diese Kombination stärkere Beschäftigung gegen eine schwächere Inflation reicht aus, um eine Sicht auf den kurzfristigen Kurs der Fed zu gestalten, ohne eine zweite Anfrage zu eröffnen.

Praktische Beispiele: EUR/USD COT Scan

Die CFTC-Verpflichtung der Händler-Berichte werden wöchentlich veröffentlicht. /latest Endpunkt gibt den letzten vollständigen Snapshot neben dem Snapshot der Vorwoche mit prozentuale Änderungen pro Feld zurück. fx_overlay Paar für Diagrammüberlagerungen:

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

Die Antwort der Vertreter:

{
  "currency": "EUR",
  "instrument": "EURO FX - CHICAGO MERCANTILE EXCHANGE",
  "fx_overlay": { "pair": "EUR/USD" },
  "source": "store",
  "latest": {
    "date": "2026-03-25",
    "announcement_datetime": 1774478400,
    "open_interest": 612380,
    "noncommercial_long": 198450,
    "noncommercial_short": 108900,
    "noncommercial_net": 89550
  },
  "previous": {
    "date": "2026-03-18",
    "announcement_datetime": 1773873600,
    "open_interest": 598200,
    "noncommercial_long": 184200,
    "noncommercial_short": 112100,
    "noncommercial_net": 72100
  },
  "pct_diff_prev": {
    "open_interest": 2.37,
    "noncommercial_long": 7.74,
    "noncommercial_short": -2.86,
    "noncommercial_net": 24.2
  }
}

In einer Antwort kann ein Positionierungssystem feststellen, dass die spekulativen EUR-Langs von 7,74% gegenüber dem Vormonat gestiegen sind, während die Shorts um 2,86% zurückgegangen sind, was die Netto-Lange-Position um mehr als 24% erweitert hat.

Praktische Beispiele: Rohstoffzustand in Python

Anstatt jede Ware unabhängig voneinander zu befragen, /latest Endpunkt gibt alle unterstützten Rohstoffindikatoren in einem einzigen Anruf zurück. Hier ist ein minimales Python-Beispiel, das den vollständigen Snapshot abruft und jede Rohstoffmarke markiert, die sich seit ihrem vorherigen Druck um mehr als 2% bewegt hat:

import requests

FXMD_API_KEY = "YOUR_API_KEY"
BASE_URL = "https://fxmacrodata.com/api/v1"

def commodities_movers(threshold_pct: float = 2.0):
    resp = requests.get(
        f"{BASE_URL}/commodities/latest",
        params={"api_key": FXMD_API_KEY},
        timeout=10,
    )
    resp.raise_for_status()
    payload = resp.json()

    movers = [
        entry for entry in payload["data"]
        if entry.get("pct_diff_prev") is not None
        and abs(entry["pct_diff_prev"]) >= threshold_pct
    ]

    print(f"Commodities snapshot as of {payload['as_of']}")
    for m in movers:
        direction = "▲" if m["pct_diff_prev"] > 0 else "▼"
        print(
            f"  {m['indicator']:20s}"
            f"  latest={m['latest']['val']} {m['unit']}"
            f"  {direction} {abs(m['pct_diff_prev']):.2f}% vs prior"
        )

commodities_movers(threshold_pct=2.0)

Das Skript macht einen einzigen API-Aufruf, unabhängig davon, wie viele Rohstoffindikatoren verfolgt werden.

Wie es mit dem Endpunkt der vollständigen Ankündigungen übereinstimmt

Die ... /latest Wenn Sie eine Zeitreihe zurücktesten, gleitende Durchschnitte erstellen, Jahresvergleiche berechnen oder ein Diagramm zeichnen möchten verwenden Sie die vollständigen Ankündigungen Endpunkt Wenn Sie den aktuellen Makro-Zustand einer Währung kennen müssen, verwenden Sie /latest- Ich weiß .

Die ... /latest Endpoint funktioniert gut in ereignisgesteuerten Workflows: Umfrage den Release-Kalender, um zu erfahren, wann ein Druck fällig ist, und ruf dann an /latest Wenn Sie einen tieferen Kontext für den gedruckten Indikator Trend, Saisonvergleich, Revisionsverlauf benötigen, können Sie mit einem gezielten Anruf der gesamten Serie zu diesem spezifischen Indikatoren folgen.

Dadurch bleibt das Gesamtverlangenvolumen proportional zu der Anzahl der Währungen, die tatsächlich Daten in einer bestimmten Sitzung veröffentlichen und nicht zur Größe Ihres Indikatoreninventars.

Beginnen Sie

Alle anderen Währungsanzeigen, COT-Daten und Rohstoffpreise erfordern einen über die ?api_key= Abfrageparameter.