# Statistiken Bundesbank — 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.

> Retrieve Deutsche Bundesbank's macroeconomic data including exchange rates, interest rates, and financial statistics by searching for specific time series or browsing topics to access historical data points. Monitor Germany's key economic indicators and financial metrics directly from the official central bank database.

**Category:** Finance & Markets | **Website:** [statistiken.bundesbank.de/statistiken-de/themen](https://statistiken.bundesbank.de/statistiken-de/themen) | **Docs:** [parse.bot/marketplace/36c07046-af1d-402d-a483-f42ffd9c3a89/statistiken-bundesbank-de-api](https://parse.bot/marketplace/36c07046-af1d-402d-a483-f42ffd9c3a89/statistiken-bundesbank-de-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-statistiken-bundesbank-de-api-36c07046/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_time_series_data

Retrieve observation data for a specific time series identified by its dataflow and series key. Returns timestamped values and series metadata (title, unit, unit multiplier, frequency). Use last_n_observations to limit to the most recent data points.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dataflow` | string | Yes | Dataflow identifier (e.g. 'BBEX3' for exchange rates, 'BBFI1' for international investment position). Obtain from search_time_series results (flow_ref field). |
| `last_n_observations` | string | No | Limit to the last N observations. When omitted, all available observations are returned. |
| `series_key` | string | Yes | Dot-separated series key identifying the specific time series within the dataflow (e.g. 'D.USD.EUR.BB.AC.000'). Obtain from search_time_series results (key field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statistiken-bundesbank-de-api-36c07046/get_time_series_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dataflow":"<string>","last_n_observations":"<string>","series_key":"<string>"}'
```

### list_topics

Retrieve the full hierarchical topic tree for Bundesbank time series. Each topic has an ID code usable as the topic parameter in search_time_series. The tree is nested: top-level topics (e.g. Außenwirtschaft, Konjunktur und Preise) contain subcategories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statistiken-bundesbank-de-api-36c07046/list_topics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_time_series

Full-text search across Bundesbank time series. Returns matching series metadata with pagination. When topic is provided, results are scoped to that topic branch (e.g. 'W1' for Außenwirtschaft). The default query '**' returns all series within the topic. Each item carries the dataflow and series key needed to fetch observations via get_time_series_data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | No | Search query text. Use '**' to match all series within the topic scope. |
| `topic` | string | No | Topic code to scope search results (e.g. 'W1' for Außenwirtschaft, 'W12' for Banken). Obtain codes from list_topics. When omitted, searches across all topics. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statistiken-bundesbank-de-api-36c07046/search_time_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","topic":"<string>"}'
```