Investing APIfr.investing.com ↗
Access today's economic calendar events from Investing.com via one API endpoint. Get scheduled announcements with actual, forecast, and previous values by country and currency.
What is the Investing API?
The Investing.com Economic Calendar API exposes a single endpoint, get_daily_events, that returns all economic announcements scheduled for the current day, structured across more than a dozen fields per event. Each response includes the event time, country, currency, importance level, and actual, forecast, and previous values where available — covering the full slate of macro releases tracked by Investing.com's daily calendar.
curl -X GET 'https://api.parse.bot/scraper/39966f1b-b5ae-4ced-9256-c8c4097b2acf/get_daily_events?language=en' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all economic announcements scheduled for today from the Investing.com economic calendar. Each event includes its scheduled time in UTC and Europe/Berlin timezone, country, currency, importance level, actual/forecast/previous values when available, and a detailed description explaining what the indicator measures, why it matters, and what higher/lower readings mean for the related currency. The endpoint always returns today's events (the date is determined server-side). Typically returns 50-80 events per day covering major economies. Supports English and French via the language parameter.
| Param | Type | Description |
|---|---|---|
| language | string | Language for event names, country names, and labels. Use "en" for English or "fr" for French. |
{
"type": "object",
"fields": {
"date": "The calendar date in YYYY-MM-DD format",
"total": "Total number of events for the day",
"events": "Array of economic event objects with time (UTC), time_berlin (Europe/Berlin local time), country, importance, actual/forecast/previous values, and description"
},
"sample": {
"data": {
"date": "2026-08-28",
"total": 92,
"events": [
{
"date": "2026-08-28",
"time": "2026-08-28T06:00:00Z",
"unit": "%",
"event": "German Import Price Index (MoM)",
"actual": "0.2%",
"period": "Jul",
"suffix": "MoM",
"country": "Germany",
"currency": "EUR",
"event_id": 134,
"forecast": "0.3%",
"previous": "-0.7%",
"is_report": false,
"is_speech": false,
"country_id": 17,
"event_long": "Germany Import Price Index MoM",
"importance": "low",
"description": "The German Import Price Index measures the change in the price of imported goods purchased domestically. A higher than expected reading should be taken as positive/bullish for the EUR, while a lower than expected reading should be taken as negative/bearish for the EUR.",
"time_berlin": "2026-08-28T08:00:00+02:00",
"revised_from": "",
"occurrence_id": 555900
}
]
},
"status": "success"
}
}About the Investing API
What the API Returns
The get_daily_events endpoint returns a JSON object with three top-level fields: date (the current calendar date in YYYY-MM-DD format), total (integer count of events scheduled that day), and events (an array of event objects). Each event object carries the scheduled release time, the country and currency it belongs to, an importance level indicating market impact, and the actual, forecast, and previous numeric values when they have been published.
Event Data Detail
The events array is the core payload. Importance levels let you filter for high-impact releases — central bank decisions, CPI prints, non-farm payrolls — versus lower-tier data. The actual value field populates as results are published during the trading day, making the endpoint useful for polling against live market hours. Forecast and previous values are typically available ahead of the release.
Scope and Freshness
The endpoint covers the current trading day only — it always reflects today's date and the events Investing.com has scheduled for that session. The total field gives an immediate count without iterating the array. No historical dates or multi-day ranges are accessible through this endpoint. There are no filter parameters; the full day's event list is returned in a single call.
The Investing API is a managed, monitored endpoint for fr.investing.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fr.investing.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fr.investing.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Alert traders when high-importance economic events are approaching based on the importance level field
- Display a live economic calendar widget that updates actual values as they are released throughout the day
- Filter events by currency to monitor macro releases affecting a specific forex pair
- Compare forecast versus actual values on release to detect market-moving surprises
- Aggregate daily event counts by country to track which markets are most active on a given session
- Trigger automated trading holds or risk-off flags when high-impact events appear in the events array
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Investing.com offer an official developer API?+
What does the importance field in each event object represent?+
Can I retrieve economic calendar data for past dates or a custom date range?+
get_daily_events endpoint always returns today's events; there is no date parameter for historical lookups or multi-day ranges. You can fork this API on Parse and revise it to add a date-range endpoint covering historical calendar data.