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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/statistiken-bundesbank/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/statistiken-bundesbank/get-time-series-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/statistiken-bundesbank/list-topics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/statistiken-bundesbank/search-time-series \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","topic":"<string>"}'
```

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