uk.investing.com 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.
curl -X GET 'https://api.parse.bot/scraper/e9336453-2dcd-48ab-9665-5232efe69319/get_calendar?end_date=2025-05-12&domain_id=51&importance=medium&start_date=2025-05-12' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| 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. Accepted values: 'low', 'medium', 'high'. Comma-separated for multiple (e.g. 'medium,high'). |
| 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 merged event/occurrence 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": "2025-05-12T10:00:00Z",
"unit": null,
"actual": null,
"source": "European Council",
"category": "central_banks",
"currency": "EUR",
"event_id": 1643,
"forecast": null,
"previous": null,
"long_name": "Eurogroup Meetings",
"page_link": "/economic-calendar/eurogroup-meetings-1643",
"country_id": 72,
"event_name": "Eurogroup Meetings",
"importance": "medium",
"source_url": "https://www.consilium.europa.eu/en/eurogroup/",
"description": "",
"preliminary": false,
"occurrence_id": 523322,
"reference_period": null,
"actual_to_forecast": "neutral",
"revised_to_previous": "neutral"
}
],
"count": 6
},
"status": "success"
}
}About the uk.investing.com 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.
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.
- 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 | 250 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.