Al final de esta guía, podrá autenticarse correctamente, elegir la familia de puntos finales adecuada para cada tarea y realizar solicitudes listas para la producción en la API FXMacroData sin adivinar la estructura de la ruta o la cobertura del indicador.
Los requisitos previos
- Una cuenta de FXMacroData y una clave de API para solicitudes que no sean en USD
- Una terminal con
curlo un tiempo de ejecución como Python/Node.js - Familiaridad básica con las respuestas JSON y los parámetros de consulta de URL
- Acceso a los documentos en vivo en /documentación/
Paso 1 - Comience con la dirección URL de la base de producción
Todos los ejemplos públicos deben comenzar desde la base de API de producción:
https://fxmacrodata.com/api/v1Las familias de puntos finales que más utilizará son:
/announcements/{currency}/{indicator}para valores históricos liberados con precisiónannouncement_datetime/calendar/{currency}para las próximas marcas de fecha de lanzamiento/catalogue/{currency}para la detección de indicadores apoyados/cot/{currency}En el caso de los instrumentos financieros, el valor de los activos financieros de la entidad de crédito es el valor del activo de la empresa de crédito./commodities/{indicator}para las series de materias primas y energía/forex/{pair}¿ Qué ?/market-sessionspara el contexto del mercado
Paso 2 - Autenticación correcta con parámetros de consulta
FXMacroData utiliza la autenticación de parámetros de consulta en ejemplos de uso público:
?api_key=YOUR_API_KEYEl acceso al punto final USD está disponible sin una clave, mientras que las rutas no USD requieren una clave válida.
# 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"Paso 3 - Descubra lo que está disponible antes de codificar
Llame primero a la ruta del catálogo cuando no esté seguro de qué indicadores existen para una moneda.
curl "https://fxmacrodata.com/api/v1/catalogue/eur?api_key=YOUR_API_KEY"Luego use el índice de la página del indicador en el índice de indicadores de documentación Para confirmar las rutas y los campos esperados.
Paso 4 - Extraer datos publicados de los puntos finales de los anuncios
Los puntos finales de anuncio devuelven un objeto de nivel superior más un data Cada fila incluye un período de fin date¿ Qué ? val, y un announcement_datetime el sello de tiempo.
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
}
]
}Para obtener la semántica y las unidades exactas del indicador, consulte las páginas de puntos finales como Tipo de interés de política en USD ¿ Qué ? Inflación en euros- ¿ Qué ?
Paso 5 - Utilice el calendario de liberación para los flujos de trabajo basados en eventos
El calendario de lanzamiento te ayuda a programar las búsquedas alrededor del tiempo de publicación en lugar de votar continuamente.
curl "https://fxmacrodata.com/api/v1/calendar/usd?indicator=non_farm_payrolls"
Un patrón robusto es: calendario de consulta -> leer a continuación announcement_datetime -> busque la ruta de anuncios correspondiente en el momento de la liberación.
Paso 6 - Añadir familias de puntos de referencia suplementarios
Una vez que el flujo de anuncios básicos esté estable, extienda la cobertura con rutas específicas de dominio:
- El COT:
/api/v1/cot/{currency}para el contexto de posicionamiento de futuros - Las demás:
/api/v1/commodities/{indicator}para el oro, la plata, el platino y los insumos de refugio seguro relacionados - El mercado de divisas:
/api/v1/forex/{pair}para la alineación al contado con las macros - Sesiones de mercado:
/api/v1/market-sessionspara la automatización de la sesión en función del estado
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"Paso 7 - Ejemplo de Python de extremo a extremo
El fragmento de abajo comprueba la disponibilidad, recupera una serie de indicadores y devuelve la última impresión.
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)
Lo que puedes construir a continuación
Ahora tiene el camino completo para autenticar, descubrir cobertura, solicitar series de lanzamiento históricas y expandirse a la automatización basada en calendario. Cómo usar la API del calendario de lanzamiento Así que su sistema reacciona exactamente cuando se publican nuevos datos macro.
