# Trading Economics Market, Indicator & Calendar Scraper (`dataspryva/trading-economics-market-indicator-and-calendar`) Actor

Get live commodity, currency, stock index, bond yield, and crypto quotes, country economic indicators and forecasts, global rankings, the economic calendar, public holidays, and corporate earnings releases from Trading Economics.

- **URL**: https://apify.com/dataspryva/trading-economics-market-indicator-and-calendar.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Automation, Developer tools, News
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Trading Economics Markets, Indicators & Calendar Scraper

Trading Economics publishes live market quotes, macro indicators, forecasts, release calendars and financial news for nearly every country. This actor turns those public pages into clean JSON: live quotes, country indicators, global rankings, economic calendar events with actual/consensus/revision values, quarterly forecasts, holidays, earnings, long historical series, market forecasts, news, keyword search, credit-rating history and full government-bond curves.

### What this actor does

- **14 modes:** `markets`, `countryIndicators`, `indicatorRanking`, `calendar`, `countryForecast`, `holidays`, `earningsCalendar`, `indicatorHistory`, `marketHistory`, `marketForecast`, `news`, `search`, `creditRatingHistory`, `bondYields`
- **Multi-country and multi-indicator:** pass several countries, ranking indicators or symbols in one run; the item cap is spread round-robin so each requested target is represented
- **Long history:** economic indicators and market prices from one month to the full available history, including intraday intervals
- **Calendar precision:** numeric actual/previous/consensus/forecast values, revision markers and a derived surprise when the units match
- **Everything else:** global rankings, quarter-ahead country projections, public holidays, global or per-country earnings, news stream, symbol search, rating histories and every bond maturity
- **Empty fields are omitted** — no nulls, empty strings or placeholder values anywhere in the output

### Services and data covered

| Service | What you get |
|---|---|
| Markets | Commodities, FX pairs, stock indices, 10Y bond yields, crypto and top-moving shares |
| Macro indicators | GDP, labour, prices, money, trade, government, business, consumer, housing, energy and health tables by country |
| Global rankings | Any of 163 indicator slugs ranked across all reporting countries, including sovereign credit ratings |
| Economic calendar | Global or filtered by country with the requested date range fetched directly |
| Forecasts | Quarter-ahead country projections and public commodity/currency/crypto/index/bond forecasts |
| Holidays and earnings | Public/bank holidays and corporate EPS/revenue release calendars |
| News and search | Latest economic/market news stream and a keyword resolver for indicators and instruments |
| History and bonds | Indicator and market time series plus 15 government-bond maturities per country |

### How it works

The actor reads the same public, no-login pages a browser sees: market tables, country pages, rankings, calendars, forecasts, holiday lists, earnings tables, rating pages, bond pages, news and search results. Historical series come from the public chart data behind each indicator or market page. It expands a requested date range into short windows so the calendar does not stop at the page's display ceiling, removes duplicate records, and stops at `maxItems` or when the source runs out. When several countries, indicators or symbols are requested, records are emitted round-robin so one large target cannot consume the whole cap; history points are newest-first. No account, API key, cookie or proxy setup is required.

### Output

Every record carries `recordType` and `scrapedAt`. Fields below are the complete contract; a field is omitted when the source does not provide it.

#### `market`

`name`, `marketType`, `category`, `maturity` (bonds), `unit`, `symbol`, `last`, `change`, `changePercent`, `weekly`, `monthly`, `ytd`, `yoy`, `marketCap`, `referenceDate`, `country`, `sourceUrl`.

#### `countryIndicator`

`indicatorName`, `country`, `category`, `last`, `previous`, `highest`, `lowest`, `unit`, `referenceDate`, `sourceUrl`.

#### `indicatorRanking`

`indicator`, `indicatorName`, `country`, `last`, `previous`, `referenceDate`, `unit`, `nextRelease`, `sourceUrl`. For `indicator=rating`: `spRating`, `dbrsRating`, `teScore`, `ratingDescription` (Moody's is not published publicly and is therefore omitted).

#### `calendarEvent`

`eventId`, `event`, `country`, `countryCode`, `category`, `symbol`, `importance`, `date`, `time`, `referencePeriod`, `actual`, `previous`, `consensus`, `forecast`, `actualValue`, `previousValue`, `consensusValue`, `forecastValue`, `previousRevisedFrom`, `surprise`, `surpriseDirection`, `sourceUrl`.

#### `countryForecast`

`indicatorName`, `country`, `category`, `unit`, `actual`, `forecasts[]` (`period`, `value`), `sourceUrl`.

#### `holiday`

`date`, `country`, `countryCode`, `holidayName`, `sourceUrl`.

#### `earnings`

`company`, `symbol`, `country`, `countryCode`, `date`, `epsActual`, `epsConsensus`, `epsPrevious`, `revenueActual`, `revenueConsensus`, `revenuePrevious`, `marketCap`, `fiscalPeriod`, `time`, `importance`, `sourceUrl`.

#### `indicatorHistoryPoint`

`country`, `indicatorName`, `indicatorSlug`, `seriesSymbol`, `category`, `unit`, `frequency`, `source`, `date`, `timestamp`, `value`, `sourceUrl`.

#### `marketHistoryPoint`

`symbol`, `name`, `date`, `timestamp`, `value`, `change`, `changePercent`, `interval`, `sourceUrl`.

#### `marketForecast`

`name`, `assetClass`, `group`, `price`, `signal`, `forecasts[]` (`period`, `value`), `sourceUrl`.

#### `news`

`newsId`, `title`, `description`, `url`, `author`, `country`, `category`, `importance`, `publishedAt`, `expiresAt`, `image`, `sourceUrl`.

#### `searchResult`

`title`, `url`, `resultType`, `group`, `category`, `country`, `frequency`, `unit`, `sourceUrl`.

#### `creditRatingEvent`

`country`, `agency`, `rating`, `outlook`, `date`, `sourceUrl`.

#### `bondYield`

`country`, `name`, `maturity`, `yield`, `dailyChange`, `monthlyChange`, `yearlyChange`, `date`, `sourceUrl`.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `markets` | One of the 14 modes listed above |
| `marketType` | string | `commodities` | mode=markets: `commodities` / `currencies` / `stocks` / `bonds` / `crypto` / `shares` |
| `category` | string | – | mode=markets: category or region filter |
| `countries` | array | `[]` | Countries for countryIndicators, countryForecast, creditRatingHistory and bondYields (required there); optional for calendar, holidays and earningsCalendar |
| `indicatorCategory` | string | – | mode=countryIndicators / countryForecast: one macro category |
| `rankingIndicators` | array | `["interest-rate"]` | mode=indicatorRanking: one or more indicator slugs |
| `indicatorHistoryUrls` | array | `[]` | mode=indicatorHistory: TE indicator URLs or `country/indicator-slug` |
| `marketSymbols` | array | `[]` | mode=marketHistory: symbols such as `CL1:COM`, `AAPL:US` or TE market URLs |
| `forecastAssetClass` | string | `commodity` | mode=marketForecast: `commodity` / `currency` / `crypto` / `stockMarket` / `governmentBond10Y` |
| `searchQuery` | string | – | mode=search: keyword to resolve, e.g. `gold` |
| `historySpan` | string | `5y` | history modes: `1m` … `10y`, `max` |
| `marketInterval` | string | `auto` | mode=marketHistory: `1m` … `1M` or `auto` |
| `searchKeyword` | string | – | Case-insensitive filter on the record name/title |
| `minChangePercent` | number | – | mode=markets: minimum daily % change |
| `maxChangePercent` | number | – | mode=markets: maximum daily % change |
| `dateFrom` | string | – | ISO date lower bound for date-aware modes |
| `dateTo` | string | – | ISO date upper bound for date-aware modes |
| `importance` | string | – | calendar / earnings / news: `low` / `medium` / `high` |
| `maxItems` | integer | `100` | Hard cap on emitted records (1–10,000); shared round-robin across requested countries/indicators/symbols |

#### Example: live energy commodities

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

#### Example: prices indicators for three countries

```json
{
  "mode": "countryIndicators",
  "countries": ["united-states", "germany", "japan"],
  "indicatorCategory": "prices",
  "maxItems": 100
}
```

#### Example: US CPI history, full available series

```json
{
  "mode": "indicatorHistory",
  "indicatorHistoryUrls": ["united-states/inflation-cpi"],
  "historySpan": "max",
  "maxItems": 2000
}
```

#### Example: high-impact calendar for one week

```json
{
  "mode": "calendar",
  "dateFrom": "2026-11-02",
  "dateTo": "2026-11-08",
  "importance": "high",
  "maxItems": 100
}
```

#### Example: intraday crude-oil prices

```json
{
  "mode": "marketHistory",
  "marketSymbols": ["CL1:COM"],
  "historySpan": "1d",
  "marketInterval": "5m",
  "maxItems": 500
}
```

### Use cases

- **Trading and macro desks** — pull quotes, curves and calendar events into a research pipeline
- **Cross-country comparison** — rank every country by rates, inflation, debt or credit rating
- **Historical research** — export multi-decade indicator series without an API subscription
- **Fintech dashboards** — feed live markets, forecasts and bond curves into a client product
- **Event monitoring** — watch high-impact releases and news for market-moving surprises
- **Journalism and academia** — bulk-export macro data with source links and timestamps

### Usage cost

Apify bills this actor per result (one dataset item = one record). Market snapshots and rankings are small runs; history modes can emit thousands of points, so set `maxItems` to the number of points you actually need. The daily prefill is intentionally the smallest run with output.

### FAQ

**Is an API key or login required?** No. The actor reads public Trading Economics pages and chart data, and works with no account, cookie or proxy setup.

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

**How fresh is the data?** Market quotes are delayed intraday values, not tick-level real-time data. Indicators and calendar events update when Trading Economics republishes a release.

**Why is `moodysRating` missing from credit ratings?** Moody's ratings are not published on the public rating pages. The actor never fabricates them; S\&P, DBRS and the Trading Economics score are returned instead.

**What is `teScore` and `ratingDescription`?** `teScore` is Trading Economics' 0–100 sovereign score. `ratingDescription` maps that score to the published grade band, such as Prime, High grade or Non-investment grade.

**How does the calendar surprise work?** `surprise` is actual minus consensus (or the published forecast when consensus is absent), emitted only when both values use the same currency, scale and unit. `surpriseDirection` is `above`, `below` or `inline`.

**Why do some calendar events lack values?** A future release has no actual yet, and some agencies publish only a previous value. Missing fields are omitted rather than filled with zero.

**Why do index and bond market forecasts show only a few rows?** Trading Economics publishes the Major group publicly; further regional index and bond forecast tables are subscription-only. Commodity, currency and crypto forecasts are public in full.

**Can I request more than one country or indicator?** Yes. Use the `countries`, `rankingIndicators` and history/market arrays. The actor fetches each target and emits round-robin, so a cap of 30 with three indicators returns about ten rows per indicator instead of thirty from the first one. Raise `maxItems` if you need every row from every target.

**Why does a history run stop before my `maxItems`?** The source itself has no more observations for that series or span, or the remaining targets produced nothing. The actor reports this rather than padding the dataset. History points are emitted newest-first so a capped run keeps the most recent observations.

### Notes

- Dates are ISO `YYYY-MM-DD`; `timestamp` is epoch seconds when the source provides one.
- Percent fields are whole percent values (for example `2.5` means 2.5%).
- `revenueActual`, `marketCap` and similar scaled figures keep their source suffix (`B`, `M`, `T`) because the scale can vary by company.
- Records are deduplicated by their natural key, so paginated calendar or news runs do not repeat rows.
- Multi-target runs make one request per requested country/indicator/symbol; `maxItems` is shared round-robin, so each target is represented before any gets a second row.
- Older saved tasks that still send `country` or `indicator` keep working; those values are mapped onto `countries` and `rankingIndicators` automatically.

### Limitations

- **Moody's ratings** are not in the public data and are never emitted.
- **Regional index and bond forecasts** beyond the Major group are paywalled by the source.
- **Calendar rendering** is capped by the source at roughly 2,000 rows per page; the actor splits long date ranges into short windows to stay under the cap.
- **News** is available 100 items per request and has no server-side country filter; the actor paginates and filters client-side.
- **Search** returns the site's fixed embedded hit set for a query rather than an open-ended index.
- **Market tables** have source-side row caps that vary by market type; use category runs for the deepest coverage.
- **Some symbols have no public chart history.** Certain futures contracts and less-covered instruments return an empty chart payload. The actor names the symbol in its status message and continues with the rest of the request.
- **Company financial statements** are not available on the public pages; only the earnings calendar fields are returned.
- **Small or low-coverage economies** may have no forecast, rating history or bond curve; those runs return the countries that do have data and leave the rest empty.

# Actor input Schema

## `mode` (type: `string`):

Which Trading Economics surface to collect.

## `marketType` (type: `string`):

Which live market table to collect.

## `category` (type: `string`):

Restrict the market table to one category or region. Commodities use Energy/Metals/Agricultural/Industrial/Livestock/Index/Electricity; currencies, stocks and bonds use Major/Europe/America/Asia/Oceania/Africa; crypto uses Crypto/BTC/ETH; shares use Top Gainers/Top Losers. Leave unset for all rows.

## `countries` (type: `array`):

One or more countries. Required for countryIndicators, countryForecast, creditRatingHistory and bondYields. Optional for calendar, holidays and earningsCalendar (leave empty for global data).

## `indicatorCategory` (type: `string`):

Restrict country indicators or forecasts to one category. `markets` only appears on the forecast page and `health` only on the indicators page. Leave unset for all categories.

## `rankingIndicators` (type: `array`):

One or more indicators to rank across every country. The `rating` indicator returns sovereign credit ratings instead of a numeric series.

## `indicatorHistoryUrls` (type: `array`):

Trading Economics indicator pages as full URLs or `country/indicator-slug`, e.g. `united-states/inflation-cpi` or `https://tradingeconomics.com/germany/unemployment-rate`. Up to 100 pages.

## `marketSymbols` (type: `array`):

Symbols such as `CL1:COM`, `AAPL:US`, `USGG10YR:IND` or full Trading Economics market URLs. Up to 100 symbols.

## `forecastAssetClass` (type: `string`):

Which public forecast table to collect.

## `searchQuery` (type: `string`):

Keyword used to resolve indicators and markets, e.g. `gold`, `inflation`, `EURUSD`. Required for mode=search.

## `historySpan` (type: `string`):

How far back to fetch historical series. `max` returns the full available history.

## `marketInterval` (type: `string`):

Intraday or daily interval for market history. Leave on `auto` to use the span's natural frequency.

## `searchKeyword` (type: `string`):

Case-insensitive substring filter on the record name/title (instrument, indicator, event, company or news headline). Leave blank for no filtering.

## `minChangePercent` (type: `number`):

Only keep instruments whose daily percent change is at least this value. Enter -5 for -5%.

## `maxChangePercent` (type: `number`):

Only keep instruments whose daily percent change is at most this value.

## `dateFrom` (type: `string`):

ISO date (YYYY-MM-DD). Lower bound for calendar, holidays, earnings, credit-rating history, bond yields and history points. For calendar this fetches the requested range, not just the default page.

## `dateTo` (type: `string`):

ISO date (YYYY-MM-DD). Upper bound for the same date-aware modes.

## `importance` (type: `string`):

Keep only releases/news at this market-impact level. Leave unset for all levels.

## `maxItems` (type: `integer`):

Hard cap on emitted records. History modes cap the total number of points across all requested series.

## Actor input object example

```json
{
  "mode": "markets",
  "marketType": "commodities",
  "category": "",
  "countries": [],
  "indicatorCategory": "",
  "rankingIndicators": [
    "interest-rate"
  ],
  "indicatorHistoryUrls": [],
  "marketSymbols": [],
  "forecastAssetClass": "commodity",
  "searchQuery": "gold",
  "historySpan": "1y",
  "marketInterval": "auto",
  "searchKeyword": "",
  "dateFrom": "",
  "dateTo": "",
  "importance": "",
  "maxItems": 3
}
```

# Actor output Schema

## `items` (type: `string`):

Dataset containing all collected Trading Economics records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "markets",
    "marketType": "commodities",
    "category": "",
    "countries": [],
    "indicatorCategory": "",
    "rankingIndicators": [
        "interest-rate"
    ],
    "indicatorHistoryUrls": [],
    "marketSymbols": [],
    "forecastAssetClass": "commodity",
    "searchQuery": "gold",
    "historySpan": "1y",
    "marketInterval": "auto",
    "searchKeyword": "",
    "dateFrom": "",
    "dateTo": "",
    "importance": "",
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/trading-economics-market-indicator-and-calendar").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "markets",
    "marketType": "commodities",
    "category": "",
    "countries": [],
    "indicatorCategory": "",
    "rankingIndicators": ["interest-rate"],
    "indicatorHistoryUrls": [],
    "marketSymbols": [],
    "forecastAssetClass": "commodity",
    "searchQuery": "gold",
    "historySpan": "1y",
    "marketInterval": "auto",
    "searchKeyword": "",
    "dateFrom": "",
    "dateTo": "",
    "importance": "",
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/trading-economics-market-indicator-and-calendar").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "markets",
  "marketType": "commodities",
  "category": "",
  "countries": [],
  "indicatorCategory": "",
  "rankingIndicators": [
    "interest-rate"
  ],
  "indicatorHistoryUrls": [],
  "marketSymbols": [],
  "forecastAssetClass": "commodity",
  "searchQuery": "gold",
  "historySpan": "1y",
  "marketInterval": "auto",
  "searchKeyword": "",
  "dateFrom": "",
  "dateTo": "",
  "importance": "",
  "maxItems": 3
}' |
apify call dataspryva/trading-economics-market-indicator-and-calendar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/trading-economics-market-indicator-and-calendar"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fCPRkrtpRlE2ekcxC/builds/46I5WSgnDTPdSK55W/openapi.json