Trading Economics API: Get country economic overview
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.
Unofficial. Not affiliated with or endorsed by Trading Economics.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Country, required
country Country name, for example Brazil.
United States
Input as JSON
{ "country": "United States"}Output
{ "country": "United States", "page_url": "https://tradingeconomics.com/united-states/indicators" , "indicators": [ { "unit": "percent", "page_url": "https://tradingeconomics.com/united-states/gdp-growth" , "latest_value": 1.5, "indicator_name": "GDP Growth Rate", "previous_value": 2.1, "reference_period": "Jun/26" }, { "unit": "percent", "page_url": "https://tradingeconomics.com/united-states/inflation-cpi" , "latest_value": 3.4, "indicator_name": "Inflation Rate", "previous_value": 3.4, "reference_period": "Aug/26" }, { "unit": "percent", "page_url": "https://tradingeconomics.com/united-states/interest-rate" , "latest_value": 4, "indicator_name": "Interest Rate", "previous_value": 3.75, "reference_period": "Sep/26" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"tradingeconomics.com/get_country_overview","input":{"country":"United States"}}' # 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": "tradingeconomics.com/get_country_overview" , "input": { "country": "United States" }})# 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": "tradingeconomics.com/get_country_overview" , "input": { "country": "United States" } }), 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 tradingeconomics.com/get_country_overview# with {"country":"United States"}"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", "required": [ "country" ], "properties": { "country": { "type": "string", "examples": [ "Brazil" ], "minLength": 1, "description": "Country name, for example Brazil." } }}Output schema
{ "type": "object", "required": [ "country", "page_url", "indicators" ], "properties": { "country": { "type": "string", "description": "Country name used on Trading Economics." }, "page_url": { "type": "string", "description": "Country overview page." }, "indicators": { "type": "array", "items": { "type": "object", "required": [ "indicator_name", "latest_value", "previous_value", "unit", "reference_period", "page_url" ], "properties": { "unit": { "type": [ "string", "null" ] }, "page_url": { "type": [ "string", "null" ] }, "latest_value": { "type": [ "number", "null" ] }, "indicator_name": { "type": "string" }, "previous_value": { "type": [ "number", "null" ] }, "reference_period": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "description": "Seven selected indicators from the country overview." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
tradingeconomics.com/get_country_overview- Returns
- country, overview page, indicator name, latest and previous value, unit, reference period, indicator 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 tradingeconomics.com/get_country_overview with the inputs above.
Ask your agent
- What are Turkey's current inflation rate, central bank interest rate and unemployment rate, along with the previous readings?
- Pull the latest macro snapshot for Indonesia from Trading Economics: GDP growth, inflation, policy rate, jobless rate, debt-to-GDP, currency and stock index.
- I need a quick economic overview of South Africa — GDP growth, government debt as a share of GDP, and how the rand and the main stock market are doing.
- Check tradingeconomics.com for Germany's key indicators and tell me the reference period for each one.
- Give me Mexico's headline economic numbers: latest vs. prior GDP growth, CPI inflation, interest rate, unemployment, public debt ratio, peso exchange rate and stock market level.
See more
All Trading Economics methodsCompares the latest reported value of an economic indicator across countries in a region, highest first. World includes all listed countries; Australia uses the Oceania region.
tradingeconomics.com/list_countries_by_indicatorGets current commodity prices and price movements from the Trading Economics commodities page, in the page's group order; filter by a commodity name, slug, symbol or group (e.g. copper, energy), or leave blank for all groups including Electricity.
tradingeconomics.com/get_commodity_pricesGets a public FRED economic series by plain name or series ID, with its observations, latest value and source details.
fred.stlouisfed.org/get_economic_indicatorLooks up an official Eurostat statistic for an EU or EEA country and the EU27 figure for the same period. Quarterly and half-yearly series return the reporting period that contains a requested month.
ec.europa.eu/get_statisticLooks up a World Bank statistic for a country and returns its annual values and latest value for the selected years.
data.worldbank.org/get_country_statisticGets 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_forecastLists 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.
investing.com/get_economic_calendarReturns the ECB's current deposit facility, main refinancing operations and marginal lending facility rates with their effective date. Optionally includes earlier rate changes, newest first.
ecb.europa.eu/get_key_interest_rates