v2.0 • REST API

API Dokumentation

Wirtschaftskalender REST API - Erhalten Sie Wirtschaftsnachrichten in Echtzeit mit KI-gestützter Analyse für Händler.

Übersicht

Die Forex Calendar Pro liefert Wirtschaftskalender-Daten in Echtzeit, gescrapt von Finanzquellen, mit optionaler KI-gestützter Analyse für Händler. Die API unterstützt mehrere Zeitzonen, Impact-Filterung und intelligentes Caching.

Basis-URL

https://api.forex-calendar.pro

Telegram-Benachrichtigungen

Pro-Benutzer können vor Handelsbeginn eine tägliche Zusammenfassung der Wirtschaftsnachrichten über Telegram erhalten.

Bot finden

Suchen Sie nach @ForexCalendarProBot auf Telegram

ID erhalten

Senden Sie /start an den Bot

ID speichern

Geben Sie Ihre Telegram-ID im Anwendungs-Dashboard ein und speichern Sie

Konfigurieren

Über das Dashboard: Aktivieren Sie Telegram-Benachrichtigungen und wählen Sie die gewünschten Ankündigungstypen

Genießen

Erhalten Sie täglich Ihr Briefing und die Liste der Wirtschaftsankündigungen

Authentifizierung

Verwenden Sie den X-API-Key Header zur Authentifizierung Ihrer Anfragen:

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

Um Ihren API-Schlüssel zu erhalten, gehen Sie zum Dashboard

Dashboard

Pläne & Zugriffsebenen

Funktion	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
Tägliches Telegram-Digest
KI-Antwortsprache	—	—

Endpunkte

GET/

Gibt API-Informationen und verfügbare Endpunkte zurück.

GET/api/announcements

Holt die heutigen Wirtschaftsnachrichten mit Impact-Filterung.

GET/api/announcements/weekFree+

Holt alle Nachrichten der aktuellen Woche.

GET/api/briefing/dailyPro

Holt ein KI-generiertes tägliches Briefing für Händler.

GET/api/announcements/analyzePro

Holt KI-Analyse einer spezifischen Wirtschaftsnachricht.

GET/api/account/usageFree+

Holt Ihre Kontonutzung und Ratenlimit-Status.

GET/api/notifications/settingsBasic+

Holt oder aktualisiert Ihre Benachrichtigungseinstellungen.

GET/api/health

Gesundheitsprüfungs-Endpunkt.

GET /api/announcements

Holt die heutigen Wirtschaftsnachrichten.

Parameter	Typ	Standard	Beschreibung
`impact`	string	high,medium	Nach Impact-Level filtern
`tz`	string	ny	Zeitzonen-Code (nur Pro)

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

Holt alle Nachrichten der aktuellen Woche. Erfordert Free-Plan oder höher.

Parameter	Typ	Standard	Beschreibung
`impact`	string	all	Nach Impact-Level filtern

Das Antwortformat ist dasselbe wie /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

Holt ein KI-generiertes tägliches Briefing für Händler. Erfordert Pro-Plan.

Zeitzonen	KI-Antwortsprache
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

Holt KI-Analyse einer spezifischen Wirtschaftsnachricht. Erfordert Pro-Plan.

Parameter	Typ	Erforderlich	Beschreibung
announcement	string	Yes	Heutiger Nachrichtentitel (das 'announcement'-Feld von /api/announcements)
`currency`	string	No	Nach Währung filtern
`tz`	string	No	Zeitzone für Sprachauswahl

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

Holt Ihre Kontonutzung und Ratenlimit-Status. Erfordert Free-Plan oder höher.

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

Holt oder aktualisiert Ihre Benachrichtigungseinstellungen. Erfordert Basic-Plan oder höher.

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

Zeitzonen

Code	Stadt	UTC-Offset
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

Impact-Level

🔴

high

Wichtige marktbewegende Nachrichten (NFP, Zinssätze, BIP)

🟠

medium

Nachrichten mit moderatem Impact

🟡

low

Kleinere Nachrichten mit begrenztem Markteinfluss

⚪

holiday

Bankfeiertage

Caching

Cache	Dauer	Invalidierung
Nachrichten (Heute)	Bis Mitternacht	Cron um 5 Uhr UTC
Nachrichten (Woche)	Bis Montag	Cron montags um 5 Uhr UTC
KI-Briefing	Täglich	Wenn neue Ergebnisse veröffentlicht werden
KI-Analyse	Täglich	Pro Ankündigung

Fehlerantworten

Ratenbegrenzung

100 Anfragen pro 15 Minuten pro IP

Verwendungsbeispiele

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"

Brauchen Sie Hilfe? Kontaktieren Sie uns unter wdltradingapi@gmail.com

Zurück zur Startseite