# ECB Financial Data Intelligence (`wakey7dev/ecb-data-intelligence`) Actor

European Central Bank exchange rates, interest rates, and banking statistics via SDMX API

- **URL**: https://apify.com/wakey7dev/ecb-data-intelligence.md
- **Developed by:** [Chris Wakefield](https://apify.com/wakey7dev) (community)
- **Categories:** Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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

## ECB Financial Data Intelligence

![Chris The Dev](https://raw.githubusercontent.com/chriswakefield87/appstore-screenshot-translator/main/assets/actor-banner.png)

Access European Central Bank financial and economic data through a simple, normalized interface.

### Features

- **Exchange Rates (EXR)**: Daily EUR exchange rates against 30+ currencies
- **Interest Rates (MIR)**: ECB monetary interest rates and bank lending rates
- **Banking Statistics (BSI)**: Euro area banking sector balance sheets
- **Balance of Payments (BOP)**: Euro area international transactions
- **Economic Forecasts (AME)**: Ameco macroeconomic data
- **Survey Data (SPF)**: Professional forecaster expectations
- **Securities Statistics (STP)**: EU securities issuance data

### Use Cases

- Financial analysis and reporting
- Economic research and forecasting
- Currency risk management
- Banking sector analysis
- Academic research
- Trading strategy development

### Input Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `dataflow` | string | ECB dataflow ID (EXR, MIR, BSI, BOP, AME, SPF, STP, FVC) |
| `currency` | string | ISO 4217 currency code (e.g., USD, GBP, JPY) - for EXR |
| `startDate` | string | Start date in YYYY-MM-DD format |
| `endDate` | string | End date in YYYY-MM-DD format |
| `frequency` | string | Data frequency (D=daily, M=monthly, Q=quarterly, A=annual) |
| `maxResults` | integer | Maximum number of data points (default: 100) |

### Example Input

```json
{
  "dataflow": "EXR",
  "currency": "USD",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31",
  "frequency": "D",
  "maxResults": 100
}
```

### Output Format

Each data point includes:

- `dataflow`: The ECB dataflow identifier
- `dataflowName`: Human-readable dataflow name
- `seriesKey`: SDMX series key
- `timePeriod`: Date/time of observation
- `value`: The data value
- `currency`: Currency code (for EXR)
- `frequency`: Data frequency
- `unit`: Measurement unit

### Data Source

Data sourced from the official [ECB Statistical Data Warehouse](https://data.ecb.europa.eu/) via the SDMX REST API. All data is freely available under the ECB's open data policy.

### API Response

The actor provides three output formats:

1. **Dataset**: Full structured data in JSON format
2. **Summary**: Human-readable table with statistics
3. **Stats**: Machine-readable metadata

### Rate Limits

The ECB API has no strict rate limits but requests should be reasonable. This actor includes built-in error handling and retry logic.

### Support

For issues or questions, please open an issue on the actor's repository.

# Actor input Schema

## `dataflow` (type: `string`):

ECB dataflow ID (e.g., EXR for exchange rates, MIR for interest rates, BSI for banking statistics)

## `currency` (type: `string`):

ISO 4217 currency code (e.g., USD, GBP, JPY) for exchange rates

## `startDate` (type: `string`):

Start date in YYYY-MM-DD format

## `endDate` (type: `string`):

End date in YYYY-MM-DD format

## `frequency` (type: `string`):

Data frequency

## `maxResults` (type: `integer`):

Maximum number of data points to return

## Actor input object example

```json
{
  "dataflow": "EXR",
  "currency": "USD",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31",
  "frequency": "D",
  "maxResults": 100
}
```

# Actor output Schema

## `results` (type: `string`):

Complete dataset with all data points

## `summary` (type: `string`):

Human-readable summary of results

## `stats` (type: `string`):

Machine-readable statistics

# 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 = {
    "currency": "USD",
    "startDate": "2024-01-01",
    "endDate": "2024-12-31"
};

// Run the Actor and wait for it to finish
const run = await client.actor("wakey7dev/ecb-data-intelligence").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 = {
    "currency": "USD",
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
}

# Run the Actor and wait for it to finish
run = client.actor("wakey7dev/ecb-data-intelligence").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 '{
  "currency": "USD",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31"
}' |
apify call wakey7dev/ecb-data-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,wakey7dev/ecb-data-intelligence"
        }
    }
}

```

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/TBxCnyrtkGIcSY31n/builds/pleTEBRCjcLwkXenT/openapi.json