# Trader Master Calendar Data (investing.com) (`pintostudio/trader-master-calendar-data-investing-com`) Actor

All-in-one Investing.com calendar scraper covering economic events, company earnings, dividends, IPO listings and stock market holidays. Pick the calendar via one input, filter by country and date range, and get clean structured JSON/CSV data - no coding or login required.

- **URL**: https://apify.com/pintostudio/trader-master-calendar-data-investing-com.md
- **Developed by:** [Pinto Studio](https://apify.com/pintostudio) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Trader Master Calendar Data (Investing.com) 🗓️📊

**One Actor, five market calendars.** Pull Investing.com's Economic, Earnings, Dividends, IPO and Stock Market Holidays calendars from a single scraper — pick the calendar with one input field and filter by country and date range. Built for traders, quants, fintech products, and anyone who needs structured market-calendar data without maintaining five separate scrapers.

***

### What this Actor does

Trader Master Calendar Data is a unified Investing.com calendar scraper. Instead of running a different tool for every calendar, you set one `calendarType` input and get back clean, structured JSON for whichever calendar you need:

| Calendar type | What you get |
| --- | --- |
| 📈 **Economic Calendar** | Macro indicators and events — GDP, CPI/inflation, interest rate decisions, employment reports, PMI, central bank meetings — with actual, forecast and previous values, plus importance rating (Low/Medium/High) |
| 💰 **Earnings Calendar** | Corporate earnings releases — EPS actual/forecast, revenue actual/forecast, market cap, reporting session (before/after market) |
| 🏦 **Dividends Calendar** | Ex-dividend dates, dividend amount, dividend type, payment date and yield for stocks worldwide |
| 🚀 **IPO Calendar** | Upcoming and recent stock listings — exchange, IPO size, price range, and last traded price |
| 🏛️ **Holidays Calendar** | Stock exchange closures around the world, by country and exchange |

All five calendars share the same filtering options (country, date range) and are written to the same dataset shape, so you can build one downstream pipeline that handles any of them.

***

### Key Features

- **Five calendars, one Actor** — switch calendar type with a single dropdown input instead of juggling separate scrapers.
- **Country filtering** — narrow any calendar down to one or more of 90+ countries and regions.
- **Date range filtering** — set a `fromDate`/`toDate` window, or leave both empty to get just today's (or this week's) entries.
- **Economic Calendar fine-tuning** — filter by importance (Low/Medium/High), category (Employment, Inflation, Central Banks, Bonds, Credit, Confidence, Balance, Economic Activity), and choose your reference time zone or time-remaining display.
- **Consistent, typed output** — every record carries `retrieved_at` and a `data_type` tag so you always know which calendar and when it was scraped.
- **Run summary included** — every run writes a summary record to the key-value store (total events found, unique countries/currencies/exchanges, etc.) so you can validate a run without opening the dataset.
- **No login, no API key, no browser required on your side** — the Actor handles all the scraping infrastructure.
- **Built for automation** — trigger it from the Apify API, schedule it to run daily/weekly, or wire it into Make, Zapier, n8n, or your own backend via webhooks.

***

### Input parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `calendarType` | Select (required) | Which calendar to scrape: `economic`, `earnings`, `dividends`, `ipo`, or `holidays`. Defaults to `economic`. |
| `country` | Array | Countries to filter by (e.g. `united states`, `united kingdom`, `germany`). Leave empty for all countries. |
| `fromDate` | Date | Start of the date range (inclusive), format `YYYY-MM-DD`. |
| `toDate` | Date | End of the date range (inclusive), format `YYYY-MM-DD`. Leave `fromDate`/`toDate` empty to fetch just today's (or this week's) entries. |
| `timeZone` | Select | *Economic Calendar only.* Reference GMT time zone for event times (e.g. `GMT +2:00`). Defaults to the local GMT offset. |
| `timeFilter` | Select | *Economic Calendar only.* Show `time_only` (event clock time) or `time_remaining` (countdown to the event). Defaults to `time_only`. |
| `importances` | Array | *Economic Calendar only.* Filter by `low`, `medium`, `high`. Leave empty for all (including holidays). |
| `categories` | Array | *Economic Calendar only.* Filter by category, e.g. `employment`, `inflation`, `central banks`, `bonds`, `credit`, `confidence`, `balance`, `economic activity`. |

***

### Example output

**Economic Calendar record:**

```json
{
  "id": "168377",
  "date": "2026-09-11",
  "time": "12:30",
  "zone": "United States",
  "currency": "USD",
  "importance": "High",
  "event": "Core CPI (MoM)",
  "actual": "0.3%",
  "forecast": "0.3%",
  "previous": "0.2%",
  "retrieved_at": "2026-09-11T15:52:49.395Z",
  "data_type": "economic_calendar_event"
}
```

**Earnings Calendar record:**

```json
{
  "date": "2026-09-11",
  "country": "united states",
  "name": "Apple Inc",
  "full_name": "Apple Inc",
  "symbol": "AAPL",
  "eps_actual": "1.64",
  "eps_forecast": "1.60",
  "revenue_actual": "94.9B",
  "revenue_forecast": "94.1B",
  "market_cap": "3.4T",
  "time": "After Market Close",
  "pair_id": "6408",
  "link": "/equities/apple-computer-inc",
  "retrieved_at": "2026-09-11T15:52:49.395Z",
  "data_type": "earnings_calendar_event"
}
```

**Dividends Calendar record:**

```json
{
  "date": "2026-09-11",
  "country": "united states",
  "name": "Microsoft Corp",
  "full_name": "Microsoft Corporation",
  "symbol": "MSFT",
  "ex_dividend_date": "11/09/2026",
  "dividend": "0.83",
  "type": "Cash",
  "payment_date": "12/12/2026",
  "yield": "0.65%",
  "link": "/equities/microsoft-corp",
  "retrieved_at": "2026-09-11T15:52:49.395Z",
  "data_type": "dividends_calendar_event"
}
```

**IPO Calendar record:**

```json
{
  "date": "2026-09-15",
  "country": "united states",
  "name": "Example Robotics Inc",
  "symbol": "EXRB",
  "exchange": "NASDAQ",
  "ipo_size": "250M",
  "price_range": "18-20",
  "last": "21.50",
  "link": "/ipo/example-robotics-inc",
  "retrieved_at": "2026-09-11T15:52:49.395Z",
  "data_type": "ipo_calendar_event"
}
```

**Holidays Calendar record:**

```json
{
  "date": "2026-11-26",
  "country": "united states",
  "exchange": "NYSE",
  "holiday": "Thanksgiving Day",
  "retrieved_at": "2026-09-11T15:52:49.395Z",
  "data_type": "holidays_calendar_event"
}
```

**Run summary (key-value store):**

Every run also writes one summary record. Its key matches the `calendarType` you ran (`economic_calendar_summary`, `earnings_calendar_summary`, `dividends_calendar_summary`, `ipo_calendar_summary` or `holidays_calendar_summary`):

```json
{
  "calendar_type": "economic",
  "total_events": 97,
  "has_data": true,
  "retrieved_at": "2026-09-11T15:52:49.395Z",
  "data_format": "json",
  "unique_currency": ["USD", "EUR", "GBP", "JPY", "..."],
  "unique_importance": ["high", "medium", "low"]
}
```

***

### Use cases

- **Trading & risk desks** — build a daily feed of high-impact economic releases (CPI, NFP, rate decisions) to avoid trading into volatility, or to time entries around known catalysts.
- **Earnings season tracking** — pull the full earnings calendar for your watchlist countries and pipe EPS/revenue actual-vs-forecast into your own dashboards.
- **Dividend income investing** — track upcoming ex-dividend dates and yields across markets to plan purchases ahead of dividend capture.
- **IPO research & deal flow** — monitor new and recent listings, pricing ranges and deal sizes across exchanges.
- **Trading calendar / holiday awareness** — know in advance when exchanges are closed in each country so automated strategies and settlement logic don't fire on non-trading days.
- **Fintech & data products** — power a calendar widget, newsletter, or Slack/Discord bot with fresh market-calendar data on a schedule.
- **Quant research** — backfill historical economic surprises (actual vs. forecast) as a feature for event-driven models.

***

### How to run this Actor

#### 1. Apify Console

1. Open the Actor and go to the **Input** tab.
2. Choose a **Calendar type** (Economic, Earnings, Dividends, IPO or Holidays).
3. Optionally narrow it down with **Countries** and a **From/To date** range.
4. For the Economic Calendar, optionally set **Time zone**, **Time filter**, **Importances** and **Categories**.
5. Click **Start** and open the **Dataset** tab once the run finishes.

#### 2. Apify API / SDK

```bash
curl "https://api.apify.com/v2/acts/pintostudio~trader-master-calendar-data-investing-com/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "calendarType": "earnings",
    "country": ["united states"],
    "fromDate": "2026-09-11",
    "toDate": "2026-09-18"
  }'
```

Or from Python / JavaScript using the [Apify Client](https://docs.apify.com/api/client):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("pintostudio/trader-master-calendar-data-investing-com").call(
    run_input={
        "calendarType": "ipo",
        "fromDate": "2026-09-11",
        "toDate": "2026-10-11",
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### 3. Scheduling

Use [Apify Schedules](https://docs.apify.com/platform/schedules) to run this Actor automatically — for example, pull the Economic Calendar every morning, or refresh the Earnings Calendar weekly during earnings season — and connect it to [integrations](https://apify.com/integrations) like Make, Zapier, Slack or Google Sheets to push fresh data wherever you need it.

***

### Cost & performance

This Actor is lightweight — it makes plain HTTP requests to Investing.com (no headless browser), so runs are fast and cheap. A typical single-calendar, single-country run for a week's date range completes in a few seconds and costs a fraction of a cent in compute units on the [Apify Pay-Per-Result / platform pricing](https://apify.com/pricing).

***

### FAQ

**Can I scrape more than one calendar in a single run?**
No — each run scrapes one calendar, selected via `calendarType`. Run the Actor (or a saved [Task](https://docs.apify.com/platform/actors/running/tasks)) once per calendar you need, or schedule multiple Tasks side by side. This keeps each run fast, cheap and easy to filter independently.

**What countries are supported?**
90+ countries and regions, from major markets (United States, United Kingdom, Germany, Japan, China) to smaller and emerging markets. Leave `country` empty to get every available country for the selected calendar.

**What date range can I request?**
Any range supported by Investing.com's calendar pages. Leave `fromDate`/`toDate` empty to default to today's (or this week's) entries, or set an explicit range for historical or forward-looking pulls.

**Do I need an Investing.com account or API key?**
No. This Actor scrapes publicly available calendar pages — you only need an Apify account to run it.

**How fresh is the data?**
Data is scraped live from Investing.com at run time. Every record includes a `retrieved_at` timestamp so you always know exactly when it was fetched.

**Can I filter the Economic Calendar by importance or category?**
Yes — use `importances` (`low`/`medium`/`high`) and `categories` (e.g. `employment`, `inflation`, `central banks`) to narrow the Economic Calendar down to the events that matter to you.

**Does this Actor work with Make, Zapier, n8n or Google Sheets?**
Yes — any Apify [integration](https://apify.com/integrations) works out of the box, since results are delivered as a standard Apify dataset you can export as JSON, CSV, Excel, or push downstream via webhooks.

***

### Support & feedback

Found a bug or have a feature request? Open an issue via the **Issues** tab on this Actor's page, or contact [Pinto Studio](https://apify.com/pintostudio) directly. Ratings and reviews help other traders and developers find this Actor — if it's useful to you, a ⭐ review is always appreciated.

***

### Related Actors

Looking for a single-purpose calendar instead of the all-in-one version? Pinto Studio also maintains focused, single-calendar Actors for Economic, Earnings, Dividends, IPO and Stock Market Holidays data — check the [Pinto Studio](https://apify.com/pintostudio) profile for the full list.

***

### Investing.com calendar scraper — economic, earnings, dividends, IPO & holidays data API

Trader Master Calendar Data is an **Investing.com scraper** and **financial calendar API** built on Apify: an **economic calendar API**, **earnings calendar scraper**, **dividend calendar data** source, **IPO calendar tracker**, and **stock market holidays calendar** in one tool. If you searched for an *Investing.com economic calendar scraper*, an *earnings calendar API*, a way to *scrape dividend dates*, an *IPO calendar API*, or *stock exchange holiday data by country*, this Actor covers all five with a single, consistent JSON schema.

Common searches this Actor answers: *investing.com economic calendar scraper*, *economic calendar API*, *earnings calendar scraper*, *earnings calendar API*, *dividend calendar scraper*, *ex-dividend date API*, *IPO calendar scraper*, *upcoming IPOs API*, *stock market holidays API*, *trading holidays by country*, *financial calendar data for trading algorithms*, *macro economic events dataset*, *CPI GDP interest rate scraper*, and *market calendar data for fintech apps*. Use it to build trading signals, backtest event-driven strategies, power a financial newsletter, feed a trading dashboard, or enrich your own fintech product with reliable, structured market-calendar data — without building and maintaining your own Investing.com scraper.

# Actor input Schema

## `calendarType` (type: `string`):

Which Investing.com calendar to scrape.

## `country` (type: `array`):

Countries to filter by. Leave empty for all countries.

## `fromDate` (type: `string`):

Start of the date range (inclusive). Leave both From/To date empty to fetch just today's (or this week's) entries.

## `toDate` (type: `string`):

End of the date range (exclusive of nothing, i.e. inclusive day).

## `timeZone` (type: `string`):

Reference time zone for event times. Only used when Calendar type is 'Economic Calendar'. Leave empty to use the local GMT offset.

## `timeFilter` (type: `string`):

Show the event's clock time, or the remaining time until it occurs.

## `importances` (type: `array`):

Event importance levels to include. Leave empty for all (including holidays).

## `categories` (type: `array`):

Event categories to include. Leave empty for all categories.

## Actor input object example

```json
{
  "calendarType": "economic",
  "country": [],
  "timeFilter": "time_only",
  "importances": [],
  "categories": []
}
```

# Actor output Schema

## `calendarEvents` (type: `string`):

No description

## `runSummary` (type: `string`):

Summary record for this run. Its key-value store key matches the calendarType you selected (e.g. economic\_calendar\_summary, earnings\_calendar\_summary, dividends\_calendar\_summary, ipo\_calendar\_summary or holidays\_calendar\_summary). Defaults to the Economic Calendar summary below.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("pintostudio/trader-master-calendar-data-investing-com").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("pintostudio/trader-master-calendar-data-investing-com").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 '{}' |
apify call pintostudio/trader-master-calendar-data-investing-com --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pintostudio/trader-master-calendar-data-investing-com"
        }
    }
}

```

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/JCFOoayRdGoFBKYjd/builds/danmc4bRz08UgzXeA/openapi.json