# Investing.com API: Get economic calendar > Lists scheduled and recent economic releases from the Investing.com economic calendar for a date range (up to 31 days, default this week), countries and importance, with actual, forecast and previous values as displayed, in the requested time zone. Unofficial. Not affiliated with or endorsed by Investing.com. - Page: https://fous.com/methods/investing.com/get-economic-calendar - Method: `investing.com/get_economic_calendar`, version 1 - Website: investing.com - Returns: release date and time, country, currency, event name, importance, actual, forecast, previous, event page - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `end_date` | string | no | | Last day of the calendar period in YYYY-MM-DD, for example 2026-10-04. Defaults to Sunday this week. | | `timezone` | string | no | | City or IANA time zone for event dates and times, for example London. Defaults to New York. Default "New York". | | `countries` | array of string | no | | Country names to include, for example ["United States", "Canada"]. Defaults to United States. Default ["United States"]. | | `importance` | string | no | | Event importance to include, for example high_only. Defaults to all. One of "high_only", "medium_and_high", "all". Default "all". | | `start_date` | string | no | | First day of the calendar period in YYYY-MM-DD, for example 2026-09-28. Defaults to Monday this week. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json {} ``` Its output: ```json { "events": [ { "actual": null, "country": "United States", "currency": "USD", "forecast": null, "previous": null, "date_time": "2026-09-28T08:15:00-04:00", "page_link": "https://www.investing.com/economic-calendar/fomc-member-bowman-speaks-1835", "event_name": "FOMC Member Bowman Speaks", "importance": "Medium" }, { "actual": "9.8", "country": "United States", "currency": "USD", "forecast": null, "previous": "11.6", "date_time": "2026-09-28T10:30:00-04:00", "page_link": "https://www.investing.com/economic-calendar/dallas-fed-mfg-business-index-658", "event_name": "Dallas Fed Mfg Business Index (Sep)", "importance": "Low" }, { "actual": "4.110%", "country": "United States", "currency": "USD", "forecast": null, "previous": "4.015%", "date_time": "2026-09-28T11:30:00-04:00", "page_link": "https://www.investing.com/economic-calendar/3-month-bill-auction-568", "event_name": "3-Month Bill Auction", "importance": "Low" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"investing.com/get_economic_calendar","input":{}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What high-impact US economic data is coming out this week, with forecasts and prior readings? - Pull the Investing.com economic calendar for Germany, France and Italy from 2026-11-02 to 2026-11-13, medium and high importance only, times in Berlin. - I need every scheduled UK and Eurozone release between March 9 and March 20, 2026, shown in London time, including actual vs. forecast. - Show me Japan and Australia economic events for next week with times in Tokyo — just the high importance ones. - On investing.com, list Canadian and US releases from 2026-01-26 through 2026-02-06 with actual, consensus and previous values, Toronto time zone. ## Input schema ```json { "type": "object", "properties": { "end_date": { "type": "string", "examples": [ "2026-10-04" ], "description": "Last day of the calendar period in YYYY-MM-DD, for example 2026-10-04. Defaults to Sunday this week." }, "timezone": { "type": "string", "default": "New York", "description": "City or IANA time zone for event dates and times, for example London. Defaults to New York." }, "countries": { "type": "array", "items": { "type": "string" }, "default": [ "United States" ], "description": "Country names to include, for example [\"United States\", \"Canada\"]. Defaults to United States." }, "importance": { "enum": [ "high_only", "medium_and_high", "all" ], "type": "string", "default": "all", "description": "Event importance to include, for example high_only. Defaults to all." }, "start_date": { "type": "string", "examples": [ "2026-09-28" ], "description": "First day of the calendar period in YYYY-MM-DD, for example 2026-09-28. Defaults to Monday this week." } } } ``` ## Output schema ```json { "type": "object", "required": [ "events" ], "properties": { "events": { "type": "array", "items": { "type": "object", "required": [ "date_time", "country", "currency", "event_name", "importance", "actual", "forecast", "previous", "page_link" ], "properties": { "actual": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "forecast": { "type": [ "string", "null" ] }, "previous": { "type": [ "string", "null" ] }, "date_time": { "type": "string", "description": "Release date and time with the requested time zone offset." }, "page_link": { "type": [ "string", "null" ], "description": "Investing.com event page." }, "event_name": { "type": "string" }, "importance": { "enum": [ "Low", "Medium", "High" ], "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Investing.com API: Get government bond yields](https://fous.com/methods/investing.com/get-bond-yields.md): Gets current government bond yields from Investing.com's world government bonds table, optionally filtered by country and maturity term. - [Investing.com API: Get commodity prices](https://fous.com/methods/investing.com/get-commodity-prices.md): Gets current quoted prices for energy, metals, and agricultural commodities from Investing.com's real-time futures page, optionally for one commodity. Some quotes may be delayed or indicative; units are null when the contract specification is missing. - [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company. - [Trading Economics API: Get country economic overview](https://fous.com/methods/tradingeconomics.com/get-country-overview.md): Returns seven key economic indicators for a country from its public Trading Economics overview: GDP growth rate, inflation rate, interest rate, unemployment rate, government debt to GDP, currency and stock market. Indicators absent from the overview are null; the US dollar index is not reported as a USD exchange rate. - [Nasdaq API: Get earnings calendar](https://fous.com/methods/nasdaq.com/get-earnings-calendar.md): Lists companies scheduled to report quarterly earnings on a date, sorted by market cap. Nasdaq supplies fiscal quarter ending by month, not exact day; unavailable figures are null. - [Time and Date API: Count business days](https://fous.com/methods/timeanddate.com/count-business-days.md): Counts weekdays between two dates, excluding nationwide public holidays or, optionally, public holidays in a state or province, from Time and Date's published holiday calendar. - [FRED API: Get economic indicator](https://fous.com/methods/fred.stlouisfed.org/get-economic-indicator.md): Gets a public FRED economic series by plain name or series ID, with its observations, latest value and source details. - [IMF API: Get economic forecast](https://fous.com/methods/imf.org/get-economic-forecast.md): Gets World Economic Outlook figures for a country or region by year, labelled as actual or forecast. Measures the IMF does not publish for a year are null. - [All Investing.com methods](https://fous.com/methods/investing.com.md)