Investing APIuk.investing.com ↗
Access economic calendar events and market holidays from Investing.com. Filter by country, importance, and date range. Returns actual, forecast, and previous values.
What is the Investing API?
This API exposes 2 endpoints covering economic calendar events and exchange-level market holidays sourced from Investing.com. The get_calendar endpoint returns merged event and occurrence records — including actual, forecast, and previous indicator values — filterable by importance level and country. The get_holidays endpoint returns exchange-specific closure data across global markets for any date range you specify.
curl -X GET 'https://api.parse.bot/scraper/e9336453-2dcd-48ab-9665-5232efe69319/get_calendar?end_date=2026-07-07&domain_id=51&importance=low&start_date=2026-07-06' \ -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 uk-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.
from parse_apis.investing.com_economic_calendar_api import InvestingCalendar, Importance
client = InvestingCalendar()
# Fetch high-importance economic events for the next few days
for event in client.calendars.events(start_date="2026-06-10", end_date="2026-06-12", importance=Importance.HIGH):
print(event.event_name, event.time, event.importance, event.actual, event.forecast, event.currency)
# Fetch market holidays
for holiday in client.calendars.holidays(start_date="2026-06-19", end_date="2026-06-20"):
print(holiday.holiday_name, holiday.holiday_start, holiday.exchange.long_name, holiday.exchange.country)
Fetch economic calendar events for a specific date range. Returns merged event definitions and occurrence data including actual, forecast, and previous values. Results can be filtered by importance level and country. Paginates as a single page up to 200 events. Each event includes metadata (category, source, description) and timing data (reference_period, actual_to_forecast sentiment).
| Param | Type | Description |
|---|---|---|
| end_date | string | End date in YYYY-MM-DD format. Defaults to start_date. |
| domain_id | string | Investing.com domain ID. |
| importance | string | Filter by importance level. Comma-separated for multiple values. |
| start_date | string | Start date in YYYY-MM-DD format. Defaults to today's date. |
| country_ids | string | Comma-separated list of country IDs to filter by. Defaults to a standard global set covering major economies. |
{
"type": "object",
"fields": {
"data": "array of EconomicEvent objects with fields: occurrence_id, time, event_id, event_name, long_name, currency, importance, actual, forecast, previous, unit, country_id, category, description, reference_period, preliminary, revised_to_previous, actual_to_forecast, source, source_url, page_link",
"count": "integer, total number of events returned"
},
"sample": {
"data": {
"data": [
{
"time": "2026-06-10T01:30:00Z",
"unit": "%",
"actual": -0.1,
"source": "National Bureau of Statistics of China",
"category": "inflation",
"currency": "CNY",
"event_id": 743,
"forecast": -0.2,
"previous": 0.3,
"long_name": "China Consumer Price Index (CPI) MoM",
"page_link": "/economic-calendar/chinese-cpi-743",
"country_id": 37,
"event_name": "CPI (MoM)",
"importance": "medium",
"source_url": "https://www.stats.gov.cn/",
"description": "The Consumer Price Index (CPI) measures the change in the prices of goods and services...",
"preliminary": false,
"occurrence_id": 549882,
"reference_period": "May",
"actual_to_forecast": "positive",
"revised_to_previous": "neutral"
}
],
"count": 122
},
"status": "success"
}
}About the Investing API
Economic Calendar Events
The get_calendar endpoint accepts a start_date and optional end_date in YYYY-MM-DD format. Each object in the returned data array merges event definition fields (event_id, event_name, long_name, currency, importance) with occurrence data (occurrence_id, time, and the three indicator values: actual, forecast, previous). The importance parameter accepts low, medium, or high as a comma-separated string, so you can fetch only high-impact releases in a single call. The country_ids parameter takes a comma-separated list of country IDs; omitting it applies a default set covering major global economies.
Market Holidays
The get_holidays endpoint returns exchange-level holiday records for a specified date range. Each object in data contains an exchange sub-object with fields including country, country_id, id, long_name, short_name, time_zone, and market_link, plus a flag indicating whether the exchange is fully closed on that date. Both endpoints share the optional domain_id parameter, which targets specific regional Investing.com domains.
Filtering and Coverage
Both endpoints default end_date to the same value as start_date when only a single day is needed, and both default to today's date when no date is supplied. The country_ids filter works the same way across both endpoints, giving a consistent interface for regional filtering. The count field at the top level of each response reports the total number of records returned, which is useful for pagination logic or data validation downstream.
The Investing API is a managed, monitored endpoint for uk.investing.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when uk.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 uk.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 trading systems before high-importance economic releases using the
importancefilter inget_calendar - Populate a financial dashboard with upcoming GDP, CPI, or employment data using
event_nameandforecastfields - Suppress automated trades on exchange closure dates using
get_holidaysfully-closed flag - Build a weekly economic briefing tool by querying
get_calendarwith a 7-day date range and filtering forhighimportance events - Synchronize backtesting pipelines with real market open/close schedules using exchange
time_zoneand holiday data - Filter economic events by currency-issuing country using
country_idsto track region-specific macro indicators - Compare forecast vs. actual values post-release to measure economic surprise for quantitative research
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. 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 `get_calendar` response include for each event occurrence?+
data array contains both the event definition fields (event_id, event_name, long_name, currency, importance) and the occurrence-specific fields (occurrence_id, time, actual, forecast, previous). The actual field is populated only after the indicator has been released; forecast and previous are available in advance.Does the `get_holidays` endpoint indicate partial trading sessions, or only full closures?+
exchange object fields. You can fork it on Parse and revise to add endpoint logic that exposes partial-session data if that distinction matters for your use case.Is there support for fetching real-time tick-level price data or historical economic time series?+
How granular is the `country_ids` filter, and what happens if I omit it?+
get_calendar and get_holidays accept country_ids as a comma-separated list of integer country IDs. If omitted, the API applies a default set covering major global economies. To target a specific subset — for example, only US and Eurozone events — you supply the corresponding IDs explicitly.