# European Central Bank — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/european-central-bank/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/european-central-bank/get-observations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/european-central-bank/get-series \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/european-central-bank/list-dataflows \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.