v2.0 • API REST

Documentation API

API REST Calendrier Économique - Obtenez des annonces économiques en temps réel avec analyse propulsée par l'IA.

Aperçu

L'API Forex Calendar Pro fournit des données de calendrier économique en temps réel scrapées depuis des sources financières, avec une analyse optionnelle propulsée par l'IA pour les traders. L'API supporte plusieurs fuseaux horaires, le filtrage par impact et un cache intelligent.

URL de base

https://api.forex-calendar.pro

Notifications Telegram

Les utilisateurs Pro peuvent recevoir un résumé quotidien des annonces économiques via Telegram avant le début de la journée de trading.

Trouver le bot

Recherchez @ForexCalendarProBot sur Telegram

Obtenir votre ID

Envoyez /start au bot

Sauvegarder votre ID

Entrez votre ID Telegram dans le dashboard de l'application et sauvegardez

Configurer

Depuis le dashboard : activez les notifications Telegram et choisissez les types d'annonces que vous souhaitez recevoir

Profiter

Recevez votre briefing quotidien et la liste des annonces économiques chaque jour

Authentification

Utilisez le header X-API-Key pour authentifier vos requêtes :

curl -H "X-API-Key: your_api_key" https://api.forex-calendar.pro/api/announcements

Pour récupérer votre clé API, rendez-vous sur le dashboard

Dashboard

Plans & Niveaux d'accès

Fonctionnalité	Free	Basic
/api/announcements (NY TZ)
/api/announcements (All TZ)
/api/announcements/week
/api/account/usage
/api/briefing/daily
/api/announcements/analyze
/api/notifications/settings
Résumé Telegram quotidien
Langue de réponse IA	—	—

Points d'accès

GET/

Retourne les informations de l'API et les points d'accès disponibles.

GET/api/announcements

Récupère les annonces économiques du jour avec filtrage par impact.

GET/api/announcements/weekFree+

Récupère toutes les annonces de la semaine en cours.

GET/api/briefing/dailyPro

Récupère un briefing quotidien généré par IA pour les traders.

GET/api/announcements/analyzePro

Récupère l'analyse IA d'une annonce économique spécifique.

GET/api/account/usageFree+

Récupère l'utilisation de votre compte et le statut des limites de débit.

GET/api/notifications/settingsBasic+

Récupère ou modifie vos préférences de notifications.

GET/api/health

Point d'accès de vérification de santé.

GET /api/announcements

Récupère les annonces économiques du jour.

Paramètre	Type	Défaut	Description
`impact`	string	high,medium	Filtrer par niveau d'impact
`tz`	string	ny	Code de fuseau horaire (Pro uniquement)

{
  "scrapeDate": "2025-12-23T10:30:00.000Z",
  "announcementsCount": 5,
  "timezone": "paris",
  "announcements": [
    {
      "date": "Mon Dec 23",
      "time": "8:30am",
      "currency": "USD",
      "impact": "high",
      "announcement": "GDP q/q",
      "actual": "2.1%",
      "forecast": "2.0%",
      "previous": "1.8%"
    }
  ]
}

GET /api/announcements/week

Récupère toutes les annonces de la semaine en cours. Nécessite le plan Free ou supérieur.

Paramètre	Type	Défaut	Description
`impact`	string	all	Filtrer par niveau d'impact

Le format de réponse est le même que /api/announcements

{
  "scrapeDate": "2025-12-25T15:02:57.863Z",
  "announcementsCount": 3,
  "announcements": [
    {
      "date": "Tue Dec 23",
      "time": "8:30am",
      "currency": "CAD",
      "impact": "high",
      "announcement": "GDP m/m",
      "actual": "-0.3%",
      "forecast": "-0.3%",
      "previous": "0.2%"
    },
    {
      "date": "Tue Dec 23",
      "time": "8:30am",
      "currency": "USD",
      "impact": "high",
      "announcement": "Prelim GDP q/q",
      "actual": "4.3%",
      "forecast": "3.3%",
      "previous": "3.8%"
    },
    {
      "date": "Wed Dec 24",
      "time": "8:30am",
      "currency": "USD",
      "impact": "high",
      "announcement": "Unemployment Claims",
      "actual": "214K",
      "forecast": "224K",
      "previous": "224K"
    }
  ]
}

GET /api/briefing/daily

Récupère un briefing quotidien généré par IA pour les traders. Nécessite le plan Pro.

Fuseaux horaires	Langue de réponse IA
paris	French
frankfurt	German
london, ny, dubai, mumbai, singapore, sydney	English
tokyo	Japanese
hongkong	Chinese

{
  "date": "2025-12-25",
  "announcementsCount": 14,
  "briefing": {
    "summary": "A mixed bag of economic data today, with Japan's Housing Starts y/y surprising with a -8.5% decline...",
    "key_announcements": [
      "12:00am | JPY | LOW | Housing Starts y/y",
      "6:50pm | JPY | LOW | Prelim Industrial Production m/m",
      "6:50pm | JPY | LOW | Retail Sales y/y"
    ],
    "market_movers": [
      "JPY: Housing Starts y/y (-8.5%) deviated significantly from forecast (0.2%)",
      "JPY: Prelim Industrial Production m/m and Retail Sales y/y may also have a significant impact"
    ],
    "risk_windows": [
      "6:50pm | JPY | LOW | Prelim Industrial Production m/m",
      "6:50pm | JPY | LOW | Retail Sales y/y"
    ],
    "currencies_in_focus": [
      "JPY: Surprising economic data and bank holidays will impact JPY pairs",
      "CHF: Bank holiday will lead to reduced trading volumes"
    ],
    "recommendation": "Focus on JPY pairs and be cautious of potential market volatility...",
    "volatility_forecast": "medium"
  },
  "announcements": [
    { "date": "Thu Dec 25", "time": "12:00am", "currency": "JPY", "impact": "low", "announcement": "Housing Starts y/y", "actual": "-8.5%", "forecast": "0.2%", "previous": "3.2%" },
    { "date": "Thu Dec 25", "time": "All Day", "currency": "CHF", "impact": "holiday", "announcement": "Bank Holiday", "actual": "", "forecast": "", "previous": "" },
    { "date": "Thu Dec 25", "time": "All Day", "currency": "EUR", "impact": "holiday", "announcement": "French Bank Holiday", "actual": "", "forecast": "", "previous": "" },
    "..."
  ],
  "language": "English",
  "generatedAt": "2025-12-25T15:05:15.245Z"
}

GET /api/announcements/analyze

Récupère l'analyse IA d'une annonce économique spécifique. Nécessite le plan Pro.

Paramètre	Type	Requis	Description
announcement	string	Yes	Titre de l'annonce du jour (champ 'announcement' retourné par /api/announcements)
`currency`	string	No	Filtrer par devise
`tz`	string	No	Fuseau horaire pour la sélection de la langue

{
  "announcement": {
    "date": "Thu Dec 25",
    "time": "All Day",
    "currency": "EUR",
    "impact": "holiday",
    "announcement": "German Bank Holiday",
    "actual": "",
    "forecast": "",
    "previous": ""
  },
  "analysis": {
    "explanation": "A German Bank Holiday may cause reduced market liquidity and trading volumes in the EUR...",
    "importance": "This announcement is important for Forex traders as it can impact EUR price movements.",
    "scenarios": {
      "above_forecast": "If the holiday results in a significant increase in economic activity, the EUR may strengthen...",
      "below_forecast": "If the holiday leads to a decrease in economic activity, the EUR may weaken..."
    },
    "pairs_to_watch": ["EUR/USD", "EUR/GBP", "EUR/JPY", "EUR/CHF"],
    "risk_level": "medium",
    "trading_tip": "Consider scaling back positions or adjusting stop-loss levels ahead of the holiday..."
  },
  "language": "English",
  "generatedAt": "2025-12-25T15:06:33.662Z"
}

GET /api/account/usage

Récupère l'utilisation de votre compte et le statut des limites de débit. Nécessite le plan Free ou supérieur.

{
  "plan": "pro",
  "email": "user@example.com",
  "language": "en",
  "telegramConfigured": true,
  "usage": {
    "requestsToday": 45,
    "requestsLimit": 100,
    "resetAt": "2025-12-23T11:00:00.000Z"
  },
  "createdAt": "2025-01-15T10:00:00.000Z",
  "lastUsedAt": "2025-12-23T10:30:00.000Z"
}

GET /api/notifications/settings

Récupère ou modifie vos préférences de notifications. Nécessite le plan Basic ou supérieur.

{
  "telegramEnabled": true,
  "telegramId": "123456789",
  "impactLevels": ["high", "medium"],
  "alertDelay": 15,
  "language": "en"
}

Fuseaux horaires

Code	Ville	Décalage UTC
ny	New York (default)	-5
paris	Paris	+1
frankfurt	Frankfurt	+1
london	London	+0
dubai	Dubai	+4
mumbai	Mumbai	+5:30
singapore	Singapore	+8
hongkong	Hong Kong	+8
tokyo	Tokyo	+9
sydney	Sydney	+11

Niveaux d'impact

🔴

high

Annonces majeures qui impactent le marché (NFP, Taux d'intérêt, PIB)

🟠

medium

Annonces à impact modéré

🟡

low

Annonces mineures avec un impact limité sur le marché

⚪

holiday

Jours fériés bancaires

Cache

Cache	Durée	Invalidation
Annonces (Aujourd'hui)	Jusqu'à minuit	Cron à 5h UTC
Annonces (Semaine)	Jusqu'à lundi	Cron le lundi à 5h UTC
Briefing IA	Quotidien	Quand de nouveaux résultats sont publiés
Analyse IA	Quotidien	Par annonce

Réponses d'erreur

Limitation de débit

100 requêtes par 15 minutes par IP

Exemples d'utilisation

JavaScript (Fetch)

const response = await fetch('https://api.forex-calendar.pro/api/announcements?impact=high', {
  headers: { 'X-API-Key': 'your_api_key' }
});
const data = await response.json();

Python

import requests

headers = {'X-API-Key': 'your_api_key'}
response = requests.get(
    'https://api.forex-calendar.pro/api/announcements',
    params={'impact': 'high,medium'},
    headers=headers
)
data = response.json()

cURL

curl -H "X-API-Key: your_api_key" \
  "https://api.forex-calendar.pro/api/announcements?impact=all"

Besoin d'aide ? Contactez-nous à wdltradingapi@gmail.com

Retour à l'accueil