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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- End Date optional
end_date Last day of the calendar period in YYYY-MM-DD, for example 2026-10-04. Defaults to Sunday this week.
Not set
- Timezone optional
timezone City or IANA time zone for event dates and times, for example London. Defaults to New York.
New York (default)
- Countries optional
countries Country names to include, for example ["United States", "Canada"]. Defaults to United States.
["United States"] (default)
List of text.
- Importance optional
importance Event importance to include, for example high_only. Defaults to all.
all (default)
One of
high_only,medium_and_high,all.- Start Date optional
start_date First day of the calendar period in YYYY-MM-DD, for example 2026-09-28. Defaults to Monday this week.
Not set
Input as JSON
{}Output
{ "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" } ]}Code
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":{}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "investing.com/get_economic_calendar" , "input": {}})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "investing.com/get_economic_calendar" , "input": {} }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run investing.com/get_economic_calendar# with {}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
investing.com/get_economic_calendar- Returns
- release date and time, country, currency, event name, importance, actual, forecast, previous, event page
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method investing.com/get_economic_calendar with the inputs above.
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.
See more
All Investing.com methodsGets current government bond yields from Investing.com's world government bonds table, optionally filtered by country and maturity term.
investing.com/get_bond_yieldsGets 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.
investing.com/get_commodity_pricesGets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.
finance.yahoo.com/get_earnings_calendarReturns 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.
tradingeconomics.com/get_country_overviewLists 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.
nasdaq.com/get_earnings_calendarCounts 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.
timeanddate.com/count_business_daysGets a public FRED economic series by plain name or series ID, with its observations, latest value and source details.
fred.stlouisfed.org/get_economic_indicatorGets 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.
imf.org/get_economic_forecast