Introducing the Currency Latest Endpoint

La numérisation de l'état macro d'une devise signifiait auparavant le déclenchement d'un appel API distinct pour chaque indicateur un pour l'inflation, un pour le chômage, un autre pour le taux directeur, etc. À partir d'aujourd'hui, vous pouvez récupérer la dernière valeur, l'impression précédente et le pourcentage de variation de la période sur la période pour chaque indicator dans une seule demande authentifiée. Le même modèle d'appel unique est maintenant disponible pour le positionnement des COT et les prix des matières premières.

Quoi de neuf ?

Trois nouveaux . /latest Les points de terminaison agrégés sont activés dans l'API FXMacroData:

Chaque réponse comprend un niveau supérieur. as_of chaque entrée d'indicateur suit une forme cohérente:

• indicateur la coquille canonique correspondant au point final des annonces
• unité Je suis désolé . fréquence du catalogue de données, afin de pouvoir formater correctement les valeurs sans une deuxième recherche
• le dernier Je suis désolé . dateJe suis désolé . val, et announcement_datetime de la version la plus récente
• précédent la précédente observation dans les mêmes domaines
• Je suis désolé. variation en pourcentage précalculée de la précédente à la dernière, arrondie à deux décimales

Pour les données de COT, pct_diff_prev est une carte plutôt qu'un scalaire un changement de pourcentage par champ de positionnement numérique (intérêt ouvert, positions longues et courtes non commerciales, positions nettes, etc.) parce que l'instantané complet de la COT est multidimensionnel.

Pourquoi cela importe aux commerçants

Si votre système surveille sept devises quelque chose comme USD, EUR, GBP, AUD, JPY, CAD et CHF avec dix à quinze indicateurs chacune, une boucle de sondage naïve peut nécessiter plus d'une centaine d'appels API individuels pour mettre à jour un tableau de bord ou alimenter un modèle.

Le /latest Les points de terminaison lus depuis le magasin d'annonces Firestore les mêmes données qui prennent en charge la série historique complète donc il n'y a pas de cache séparé ou de décalage introduit par l'appel global. Les données que vous obtenez sont identiques à la requête de chaque indicateur individuellement.

Exemple pratique: le macro-instantané USD

Vous suivez le tableau macro des États-Unis avant l'ouverture de New York. /latest Endpoint renvoie l'état actuel de chaque indicateur suivi, chacun avec son impression précédente et le changement entre eux:

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

Réponse représentative (trincée en trois indicateurs):

{
  "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
    }
  ]
}

À partir de cette réponse unique , un trader ou un modèle peut immédiatement lire ce titre . Inflation en dollars américains Les salaires des salariés non agricoles ont augmenté de façon significative par rapport au mois précédent. taux de chômage Cette combinaison d'un meilleur taux d'emploi contre une inflation plus faible est suffisante pour donner une image de la trajectoire à court terme de la Fed sans ouvrir une deuxième demande.

Exemple pratique: analyse COT de l'EUR/USD

Les rapports de la CFTC sur l'engagement des traders sont publiés chaque semaine. /latest pour EUR, l'appel inclut également le taux de change conventionnel fx_overlay paire pour les superpositions de graphiques:

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

Réponse du représentant:

{
  "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
  }
}

Dans une réponse, un système de positionnement peut voir que les longs spéculatifs de l'EUR ont augmenté de 7,74% en semaine sur semaine tandis que les courts ont diminué de 2,86%, élargissant ainsi la position longue nette de plus de 24%.

Exemple pratique: État des marchandises en Python

Au lieu de procéder à un sondage indépendant sur chaque produit, les produits /latest endpoint renvoie tous les indicateurs de marchandise pris en charge en un seul appel. Voici un exemple Python minimal qui récupère l'instantané complet et marque toute marchandise qui a évolué de plus de 2% depuis son impression précédente:

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)

Le script effectue un seul appel API indépendamment du nombre d'indicateurs de matières premières suivis.

Comment il s'adapte à la fin des annonces complètes

Le /latest Lorsque vous avez besoin d'une série temporelle backtesting, de construire des moyennes mobiles, de calculer des comparaisons annuelles ou de dessiner un graphique utilisez la série complète annonces point final Lorsque vous avez besoin de connaître l'état macro actuel d'une monnaie en ce moment, utilisez /latestJe suis désolé .

Le /latest endpoint fonctionne bien dans les flux de travail basés sur des événements: consultez le calendrier de sortie pour savoir quand une impression est attendue, puis appelez /latest Si vous avez besoin d'un contexte plus approfondi pour l'indicateur imprimé tendance, comparaison saisonnière, historique des révisions , suivez-le avec un appel ciblé à l'ensemble de la série à cet indicateur spécifique.

Cela permet de maintenir le volume total des demandes proportionnel au nombre de devises qui publient réellement des données dans une session donnée et non à la taille de votre inventaire d'indicateurs.

Commencez à écrire

Les annonces en USD sont publiques. Toutes les autres annonces de devises, données COT et prix des matières premières nécessitent une clé API authentifiée fournie via le ?api_key= paramètre de requête.