Trading Economics Scraper

Scrape Trading Economics — live commodities, currencies, stock indices, government bond yields, cryptocurrency prices and top-moving individual shares; country-by-country economic indicators (GDP, inflation, unemployment...); global indicator rankings across every tracked country; and the daily economic calendar of upcoming/recent releases. HTTP-only via the public tradingeconomics.com tables. No auth, no proxy, no login.

What this actor does

• Seven modes: markets, countryIndicators, indicatorRanking, calendar, countryForecast, holidays, earningsCalendar
• Every market axis: commodities (7 categories), currencies, stock indices, bond yields, crypto and top-gaining/losing individual shares — each split into regions/categories
• Every country's indicators: 12 categories (GDP, labour, prices, money, trade, government, business, consumer, housing, energy, health, overview) for any of 190+ countries
• Global rankings: 163 indicators (interest rate, inflation, unemployment, GDP growth, credit rating, wages, trade, health, demographics, energy...) ranked across every country that reports them
• Economic calendar: global or per-country, with actual/previous/consensus/forecast values and date-range filtering
• Country forecasts: Trading Economics' own quarter-ahead projections (next 4 quarters) for every indicator on a country's page, plus currency/stock-market/bond-yield market forecasts
• Public holidays: global list of upcoming market/bank holidays across every tracked country, or the full-year holiday list for a single country, with ISO dates and country codes
• Earnings calendar: per-country corporate earnings releases (EPS/revenue actual, consensus, previous, market cap, fiscal period, report time, market-impact rating)
• Empty fields are omitted — no null placeholders anywhere in the output

Output: markets (mode = markets)

• name — instrument name (e.g. Crude Oil, EURUSD, US500, United States, Bitcoin, Airbnb)
• marketType — commodities / currencies / stocks / bonds / crypto / shares
• category — table category/region (e.g. Energy, Major, Europe, Crypto, Top Gainers)
• unit — pricing unit (commodities only, e.g. USD/Bbl)
• symbol — exchange ticker symbol
• last — latest price / yield
• change, changePercent — absolute and percent change since previous close
• weekly, monthly, ytd, yoy — percent change over each period
• marketCap — crypto only
• referenceDate — date of the latest quote
• country — derived when the instrument maps to a specific country (currencies/stocks/bonds)
• sourceUrl
• recordType: "market", scrapedAt

Output: country indicators (mode = countryIndicators)

• indicatorName — e.g. GDP Growth Rate, Unemployment Rate
• country, category — one of overview/gdp/labour/prices/money/trade/government/business/consumer/housing/energy/health
• last, previous, highest, lowest
• unit — e.g. percent, USD Billion
• referenceDate
• sourceUrl
• recordType: "countryIndicator", scrapedAt

Output: indicator ranking (mode = indicatorRanking)

• indicator — the ranked indicator slug
• country
• last, previous
• referenceDate, unit, nextRelease
• For indicator=rating (sovereign credit rating): spRating, moodysRating, dbrsRating, teScore instead of last/previous
• sourceUrl
• recordType: "indicatorRanking", scrapedAt

Output: calendar events (mode = calendar)

• event — release name (e.g. Balance of Trade, Inflation Rate YoY)
• country, countryCode
• category — the underlying indicator series this release belongs to (e.g. Interest Rate, Inflation Rate Mom)
• symbol — Trading Economics ticker symbol for the series, when published (e.g. CNCPIYOY)
• importance — market-impact level Trading Economics assigns the release: Low / Medium / High (omitted for the handful of rows TE doesn't rate, e.g. bank holidays)
• date (ISO YYYY-MM-DD), time
• referencePeriod — the period the release covers (e.g. JUL, Q2), when published
• actual, previous, consensus, forecast
• sourceUrl
• recordType: "calendarEvent", scrapedAt

Output: country forecasts (mode = countryForecast)

• indicatorName — e.g. GDP Growth Rate, Currency, Stock Market
• country, category — one of overview/gdp/labour/prices/money/trade/government/business/consumer/housing/energy/markets (markets = currency / stock market / 10Y bond yield forecast, not on the countryIndicators page)
• unit — e.g. %, USD Billion, points
• actual — latest reported value
• forecasts — array of { period, value } for Trading Economics' next four forecasted quarters (e.g. Q3/26, Q4/26...); quarter labels shift forward every release, so they're carried as data rather than fixed field names
• sourceUrl
• recordType: "countryForecast", scrapedAt

Output: public holidays (mode = holidays)

• date — ISO YYYY-MM-DD
• country
• countryCode — 2-letter code Trading Economics assigns the country's flag (e.g. US, TZ)
• holidayName — e.g. New Year's Day, National Day
• sourceUrl
• recordType: "holiday", scrapedAt

Output: earnings calendar (mode = earningsCalendar)

• company — company name (e.g. Berkshire Hathaway)
• symbol — Trading Economics ticker (e.g. BRKB:US)
• country, countryCode
• date — ISO YYYY-MM-DD report date
• epsActual, epsConsensus, epsPrevious — earnings per share (actual is omitted until the report is released)
• revenueActual, revenueConsensus, revenuePrevious — revenue text with K/M/B magnitude suffix (e.g. 96.52B)
• marketCap — e.g. $688.51B
• fiscalPeriod — e.g. Q2
• time — AM or PM report session, when published
• importance — market-impact level Trading Economics assigns the release: Low / Medium / High
• sourceUrl
• recordType: "earnings", scrapedAt

Input

Field	Type	Default	Description
mode	string	markets	markets / countryIndicators / indicatorRanking / calendar / countryForecast / holidays / earningsCalendar
marketType	string	commodities	mode=markets: commodities / currencies / stocks / bonds / crypto / shares
category	string	–	mode=markets: category/region filter (options depend on marketType)
country	string	–	mode=countryIndicators / mode=countryForecast / mode=earningsCalendar (all required — pick a country) / mode=calendar / mode=holidays (both optional, leave unset for the global calendar / global holiday list)
indicatorCategory	string	–	mode=countryIndicators: restrict to one of 12 categories. mode=countryForecast: restrict to one of 12 categories (markets instead of health)
indicator	string	interest-rate	mode=indicatorRanking: which indicator to rank across countries (163 available — macro, labour, trade, prices, health, demographics, energy...)
searchKeyword	string	–	Case-insensitive substring match against the record name/event/holiday
minChangePercent	number	–	mode=markets: minimum daily % change
maxChangePercent	number	–	mode=markets: maximum daily % change
dateFrom	string	–	mode=calendar, holidays: ISO date (YYYY-MM-DD), inclusive lower bound
dateTo	string	–	mode=calendar, holidays: ISO date (YYYY-MM-DD), inclusive upper bound
importance	string	–	mode=calendar: keep only low / medium / high impact events; leave unset for all
maxItems	integer	100	Hard cap on emitted records (1–2000)

Example: all commodities, energy only

{
  "mode": "markets",
  "marketType": "commodities",
  "category": "Energy",
  "maxItems": 50
}

Example: US economic indicators, GDP category

{
  "mode": "countryIndicators",
  "country": "united-states",
  "indicatorCategory": "gdp",
  "maxItems": 50
}

Example: interest rates ranked across every country

{
  "mode": "indicatorRanking",
  "indicator": "interest-rate",
  "maxItems": 100
}

Example: today's global economic calendar

{
  "mode": "calendar",
  "maxItems": 100
}

Example: quarter-ahead forecasts for Germany's GDP indicators

{
  "mode": "countryForecast",
  "country": "germany",
  "indicatorCategory": "gdp",
  "maxItems": 50
}

Example: upcoming public holidays for Germany

{
  "mode": "holidays",
  "country": "germany",
  "maxItems": 50
}

Example: upcoming US corporate earnings, high impact only

{
  "mode": "earningsCalendar",
  "country": "united-states",
  "importance": "high",
  "maxItems": 50
}

Use cases

• Trading desks — pull live commodity/currency/index/bond quotes into a research pipeline
• Macro research — compare a country's GDP/inflation/unemployment trajectory over categories
• Cross-country benchmarking — rank every country by interest rate, credit rating or debt-to-GDP
• Event-driven strategies — track the economic calendar for upcoming releases that move markets
• Fintech dashboards — feed live market and indicator data into a client-facing product
• Academic / journalistic research — bulk-export macro data without manual copy-paste

FAQ

What's the data source? The public tables on tradingeconomics.com — no API key, login or paid subscription required.

Is this affiliated with Trading Economics? No — this is an independent, third-party actor that reads the same public pages a browser would.

How fresh is the data? Market quotes update intraday (delayed, not real-time tick data). Country indicators and calendar events update as Trading Economics republishes each release.

Why do some market rows lack a country field? country is only populated when the instrument maps to a specific country page (currencies, stock indices, bond yields). Commodities and crypto pairs are global instruments and don't have a single country.

What does category mean for mode=markets? It depends on marketType: for commodities it's a sector (Energy, Metals, ...); for currencies/stocks/bonds it's a geographic region (Major, Europe, ...); for crypto it's the quote currency grouping (Crypto = USD pairs, BTC/ETH = altcoin pairs).

Why does indicator=rating return different fields? Sovereign credit ratings are letter grades (AAA, Baa2...) from three agencies, not a single numeric series, so that ranking returns spRating/moodysRating/dbrsRating/teScore instead of last/previous.

Can I get a specific country's calendar? Yes — set country (e.g. united-states) in mode=calendar; omit it for the global calendar across all countries.

What does importance mean for calendar events? It's Trading Economics' own market-impact rating for the release (Low/Medium/High) — the same color-coding shown on their site. Use the importance input to keep only one level, e.g. high for the releases most likely to move markets.

Can I get a specific country's upcoming corporate earnings? Yes — set country (e.g. united-states) in mode=earningsCalendar (required). epsActual/revenueActual are omitted until the company actually reports; until then only the consensus/previous figures are populated.

Can I get a specific country's public holidays? Yes — set country (e.g. germany) in mode=holidays for that country's full-year holiday list; omit it for the global upcoming-holidays list (from today through the end of the year, across every tracked country).

What if my country or indicator filter matches nothing? The actor returns zero records and sets a clear status message rather than emitting a placeholder record.

What are the period labels in forecasts (mode=countryForecast)? Trading Economics forecasts four quarters ahead of the current one (e.g. Q3/26, Q4/26, Q1/27, Q2/27 as of Q2 2026); the labels roll forward every quarter, so they're returned as data on each forecast entry instead of fixed output columns. Not every small economy has forecast coverage — those return zero records.