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.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/39966f1b-b5ae-4ced-9256-c8c4097b2acf/get_daily_events' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fr-investing-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Investing.com Economic Calendar — fetch today's events."""
from parse_apis.fr_investing_com_api import InvestingCalendar, ParseError
client = InvestingCalendar()
# Fetch today's full economic calendar
try:
calendar = client.calendars.today()
except ParseError as e:
print(f"Extraction failed ({e.code}): {e}")
raise
print(f"Date: {calendar.date} — {calendar.total} events scheduled")
# Show high-importance events with their actual vs forecast values
for ev in calendar.events:
if ev.importance == "high":
print(f"[{ev.time}] {ev.country} — {ev.event}: actual={ev.actual}, forecast={ev.forecast}, previous={ev.previous}")
print("exercised: calendars.today")
Returns all economic announcements scheduled for today from the Investing.com economic calendar. Each event includes its scheduled time, country, currency, importance level, and actual/forecast/previous values when available. The endpoint always returns today's events (the date is determined server-side). Typically returns 50-80 events per day covering major economies.
No input parameters required.
{
"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, country, importance, actual/forecast/previous values"
},
"sample": {
"data": {
"date": "2026-08-19",
"total": 68,
"events": [
{
"date": "2026-08-19",
"time": "2026-08-19T01:30:00Z",
"unit": "%",
"event": "Indice des coûts salariaux",
"actual": "0,8 %",
"period": "(T2)",
"suffix": "(Trimestriel)",
"country": "Australia",
"currency": "AUD",
"event_id": 336,
"forecast": "0,8 %",
"previous": "0,8 %",
"is_report": false,
"is_speech": false,
"country_id": 25,
"event_long": "Australie - Indice des coûts salariaux (intertrimestriel)",
"importance": "medium",
"revised_from": "",
"occurrence_id": 555123
},
{
"date": "2026-08-19",
"time": "2026-08-19T06:00:00Z",
"unit": "%",
"event": "IPC",
"actual": "2,9 %",
"period": "(Juill.)",
"suffix": "(Annuel)",
"country": "United Kingdom",
"currency": "GBP",
"event_id": 67,
"forecast": "2,9 %",
"previous": "2,6 %",
"is_report": false,
"is_speech": false,
"country_id": 4,
"event_long": "Royaume-Uni - Indice des prix à la consommation (IPC) (interannuel)",
"importance": "high",
"revised_from": "",
"occurrence_id": 554444
}
]
},
"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.