# European Central Bank — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access official European Central Bank statistical series and observations to retrieve economic data like exchange rates, interest rates, and monetary aggregates. Browse available dataflows and retrieve specific time series data to analyze ECB's published economic indicators.

**Category:** Finance & Markets | **Website:** [data.ecb.europa.eu/](https://data.ecb.europa.eu/) | **Docs:** [parse.bot/marketplace/1bf8dbc5-e749-4b97-a1b4-b72393397bc9/data-ecb-europa-eu-api](https://parse.bot/marketplace/1bf8dbc5-e749-4b97-a1b4-b72393397bc9/data-ecb-europa-eu-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-data-ecb-europa-eu-api-1bf8dbc5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_observations

Retrieve a simplified list of observations (period, value, period_name) for a specific ECB series. Returns data from the ECB portal detail API in a flat, easy-to-consume format. Each observation includes the period start date, the numeric value as a string, and a human-readable period label. Results are ordered most-recent first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `flow_ref` | string | Yes | Dataflow identifier from list_dataflows (e.g. 'EXR' for Exchange Rates). |
| `series_key` | string | Yes | Dot-separated series key within the dataflow (e.g. 'M.USD.EUR.SP00.A' for monthly USD/EUR exchange rate). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-ecb-europa-eu-api-1bf8dbc5/get_observations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"flow_ref":"<string>","series_key":"<string>"}'
```

### get_series

Retrieve full SDMX-JSON data for a specific ECB series, including all observations, dimensional metadata, and attributes. Use flow_ref and series_key to identify the series. The response follows the SDMX-JSON standard with header, dataSets (containing indexed observations), and structure (describing dimensions and attributes). Optional parameters allow filtering by time period or limiting observation count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `detail` | string | No | Level of detail: 'full', 'dataonly', 'serieskeysonly', 'nodata'. |
| `end_period` | string | No | End of the time range filter in ISO format YYYY-MM-DD or YYYY-MM or YYYY. |
| `first_n` | string | No | Return only the first N observations. |
| `flow_ref` | string | Yes | Dataflow identifier from list_dataflows (e.g. 'EXR' for Exchange Rates, 'ICP' for consumer prices). |
| `include_history` | string | No | Whether to include history of revisions: 'true' or 'false'. |
| `last_n` | string | No | Return only the last N observations. |
| `series_key` | string | Yes | Dot-separated series key within the dataflow (e.g. 'M.USD.EUR.SP00.A' for monthly USD/EUR exchange rate). |
| `start_period` | string | No | Start of the time range filter in ISO format YYYY-MM-DD or YYYY-MM or YYYY. |
| `updated_after` | string | No | ISO 8601 timestamp to retrieve only data updated after this time. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-ecb-europa-eu-api-1bf8dbc5/get_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"detail":"<string>","end_period":"<string>","first_n":"<string>","flow_ref":"<string>","include_history":"<string>","last_n":"<string>","series_key":"<string>","start_period":"<string>","updated_after":"<string>"}'
```

### list_dataflows

List all available dataflows (datasets) from the ECB. Returns identifiers, agency, version, and human-readable names for each dataflow. The full catalog typically contains 70+ dataflows covering exchange rates, monetary aggregates, interest rates, balance of payments, and more. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-ecb-europa-eu-api-1bf8dbc5/list_dataflows \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```