Introducción del último punto de finalización de la moneda: Una llamada para la instantánea completa de la macro

El escaneo del estado macro de una moneda solía significar disparar una llamada API separada para cada indicador una para la inflación, una para el desempleo, una por la tasa de política, y así sucesivamente. A partir de hoy, puede recuperar el valor más reciente, la impresión anterior y el cambio porcentual del período sobre el período para cada indicador en una sola solicitud autenticada. El mismo patrón de una llamada está ahora disponible para el posicionamiento de COT y los precios de los productos básicos.

¿Qué hay de nuevo?

Tres nuevos . /latest Los puntos finales agregados están en vivo en la API FXMacroData:

Cada respuesta incluye un nivel superior as_of Cada entrada de indicador sigue una forma consistente:

• el indicador la cara de la cara que coincide con el punto final de los anuncios
• Unidad ¿ Qué ? frecuencia desde el catálogo de datos, para que pueda dar formato a los valores correctamente sin necesidad de una segunda búsqueda
• más reciente ¿ Qué pasa ? date¿ Qué ? val, y announcement_datetime de la edición más reciente
• anterior la observación anterior en los mismos campos
• ¿ Qué es esto? cambio porcentual precalculado de anterior a último, redondeado a dos decimales

Para los datos de COT, pct_diff_prev es un mapa más que un escalar un cambio porcentual por campo de posicionamiento numérico (interés abierto, posiciones largas y cortas no comerciales, posición neta, etc.) porque la instantánea completa de COT es multidimensional.

Por qué es importante para los comerciantes

Si su sistema monitorea siete monedas algo como USD, EUR, GBP, AUD, JPY, CAD y CHF con diez a quince indicadores cada una, un bucle de encuestas ingenuo puede requerir más de cien llamadas individuales de API para actualizar un panel de control o alimentar un modelo.

El /latest Los puntos finales leídos de la tienda de anuncios de Firestore los mismos datos que respaldan la serie histórica completa por lo que no hay caché o retraso separados introducidos por la llamada agregada. Los datos que obtiene son idénticos a la consulta de cada indicador individualmente.

Ejemplo práctico: USD Macro Snapshot

Estáis observando el panorama macro de los Estados Unidos antes de la apertura de Nueva York. /latest Endpoint devuelve el estado actual de cada indicador rastreado, cada uno con su impresión anterior y el cambio entre ellos:

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

Respuesta representativa (truncada en tres indicadores):

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

A partir de esta única respuesta un comerciante o modelo puede leer inmediatamente ese titular Inflación en dólares La tasa de desempleo de los trabajadores no agrícolas se ha incrementado ligeramente con respecto al mes anterior, mientras que la de los no agrícolas ha aumentado significativamente con respecto a la del mes anterior. tasa de desempleo Esta combinación un empleo más fuerte frente a una inflación más débil es suficiente para dar forma a una visión sobre la trayectoria a corto plazo de la Fed sin abrir una segunda solicitud.

Ejemplo práctico: EUR/USD COT Scan

Los informes de compromiso de los operadores de la CFTC se publican semanalmente. /latest En el caso de EUR, la llamada también incluye el valor convencional fx_overlay Par para superposiciones de gráficos:

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

Respuesta de los representantes:

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

En una respuesta, un sistema de posicionamiento puede ver que los EUR long especulativos aumentaron un 7,74% semana tras semana mientras que los shorts se contrajeron un 2,86%, ampliando la posición larga neta en más de un 24%.

Ejemplo práctico: Estado de las mercancías en Python

En lugar de hacer una encuesta de cada producto de forma independiente en un calendario, los productos /latest Endpoint devuelve todos los indicadores de productos básicos soportados en una sola llamada. Aquí hay un ejemplo de Python mínimo que recupera la instantánea completa y señala cualquier producto que se haya movido más del 2% desde su impresión anterior:

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)

El script hace una sola llamada de API independientemente de cuántos indicadores de materias primas se rastrean.

Cómo encaja con el punto final de los anuncios completos

El /latest Cuando se necesita una serie de tiempo backtesting, construcción de promedios móviles, cálculo de comparaciones de año a año, o dibujo de un gráfico utilizar el completo Anuncios punto final Cuando necesite saber el estado macro actual de una moneda ahora mismo, use /latest- ¿ Qué ?

El /latest Endpoint funciona bien en flujos de trabajo basados en eventos: consulta el calendario de lanzamiento para saber cuándo se debe imprimir, luego llama /latest Si necesita un contexto más profundo para el indicador impreso tendencia, comparación estacional, historial de revisiones , haga un seguimiento con una llamada específica de la serie completa a ese indicador específico.

Esto mantiene el volumen total de solicitudes proporcional a la cantidad de monedas que publican datos en una sesión determinada y no al tamaño de su inventario de indicadores.

Empieza

Todos los demás anuncios de divisas, datos COT y precios de materias primas requieren una clave API autenticada suministrada a través del ?api_key= Parámetro de consulta.