À la fin de ce guide, vous serez en mesure de vous authentifier correctement, de choisir la bonne famille de terminaux pour chaque tâche et de faire des demandes prêtes à la production à travers l'API FXMacroData sans deviner la structure de la route ou la couverture des indicateurs.
Pré-requis
- Un compte FXMacroData et une clé API pour les demandes autres que USD
- Un terminal avec ...
curlou un runtime comme Python/Node.js - Familiarité de base avec les réponses JSON et les paramètres de requête URL
- Accès aux documents en direct à /documentation/
Étape 1 - Commencez par l'URL de la base de production
Tous les exemples publics devraient commencer par la base de production API:
https://fxmacrodata.com/api/v1Les familles de points de fin que vous utiliserez le plus sont:
/announcements/{currency}/{indicator}pour les valeurs historiques publiées avec précisionannouncement_datetime/calendar/{currency}pour les timestamps de sortie à venir/catalogue/{currency}pour la découverte des indicateurs soutenus/cot/{currency}pour le positionnement des engagements des opérateurs/commodities/{indicator}pour les séries de produits de base et d'énergie/forex/{pair}Je suis désolé ./market-sessionspour le contexte du marché
Étape 2 - Authentifier correctement avec les paramètres de requête
FXMacroData utilise l' authentification par paramètre de requête dans les exemples d'utilisation publique:
?api_key=YOUR_API_KEYL'accès au point de terminaison USD est disponible sans clé, tandis que les routes non USD nécessitent une clé valide.
# 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"Étape 3 - Découvrez ce qui est disponible avant de coder
Appellez d'abord la route du catalogue lorsque vous n'êtes pas sûr des indicateurs existant pour une devise.
curl "https://fxmacrodata.com/api/v1/catalogue/eur?api_key=YOUR_API_KEY"Ensuite, utilisez l'index de la page de l'indicateur dans l'indice des indicateurs de documentation pour confirmer les itinéraires et les champs prévus.
Étape 4 - Extraction des données publiées des points de terminaison des annonces
Les terminaisons d'annonce renvoient un objet de niveau supérieur plus un data Chaque ligne comprend une fin de période dateJe suis désolé . val, et un announcement_datetime l'heure de l'événement.
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
}
]
}Pour la sémantique et les unités exactes des indicateurs, consultez les pages de points de fin telles que Taux directeur en USD Je suis désolé . Inflation en eurosJe suis désolé .
Étape 5 - Utiliser le calendrier de sortie pour les flux de travail axés sur les événements
Le calendrier de sortie vous aide à planifier les récupérations autour du moment de la publication au lieu de faire des sondages en continu.
curl "https://fxmacrodata.com/api/v1/calendar/usd?indicator=non_farm_payrolls"
Un modèle robuste est: calendrier de requête -> lire ensuite announcement_datetime -> récupérer la route correspondante des annonces au moment de la sortie.
Étape 6 - Ajout de familles de critères de jugement supplémentaires
Une fois que votre flux d'annonces de base est stable, étendre la couverture avec des itinéraires spécifiques au domaine:
- Le code de la pêche
/api/v1/cot/{currency}pour le contexte du positionnement sur les contrats à terme - autres métaux:
/api/v1/commodities/{indicator}pour l'or, l'argent, le platine et les intrants de refuge sécurisé connexes - Le Forex:
/api/v1/forex/{pair}pour l'alignement au comptant avec les macro-libérations - Sessions de marché:
/api/v1/market-sessionspour l'automatisation de la session en fonction de l'état de la séance
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"Étape 7 - Exemple de Python de bout en bout
L'extrait ci-dessous vérifie la disponibilité, récupère une série d'indicateurs et renvoie la dernière impression.
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)
Ce que vous pouvez construire ensuite
Vous avez maintenant le chemin complet pour authentifier, découvrir la couverture, demander des séries de sorties historiques, et étendre dans l'automatisation basée sur le calendrier. Comment utiliser l'API du calendrier de sortie Ainsi, votre système réagit exactement quand de nouvelles données macro sont publiées.
