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

> Search for stocks and assets, retrieve live prices, view index components, and access historical price data to track market performance and make informed investment decisions. Monitor real-time market quotes and analyze past price trends across multiple financial instruments on one platform.

**Category:** Finance & Markets | **Website:** [finanzen.net/](https://finanzen.net/) | **Docs:** [parse.bot/marketplace/a3c12eb5-40c0-4d69-872f-43c12c777da8/finanzen-net-api](https://parse.bot/marketplace/a3c12eb5-40c0-4d69-872f-43c12c777da8/finanzen-net-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/finanzen/`
**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 current price

Retrieve the current price and basic metadata for any asset (stock, index, commodity, ETF, fund, or currency pair). Searches by name, ISIN, or WKN. Returns the asset's display name, ISIN, ticker symbol, and the latest quoted price including currency unit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Asset name, ISIN, or WKN (e.g., 'Apple', 'US0378331005', '846900'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/finanzen/get-current-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Get historical prices

Fetch historical price data for an asset over a specified date range. Returns daily OHLCV data (open, high, low, close, volume) for each trading day. If no date range is provided, defaults to the last 30 days. Dates use DD.MM.YYYY format. The asset is resolved by name, ISIN, or WKN.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date in DD.MM.YYYY format (e.g., '15.04.2026'). |
| `query` | string | Yes | Asset name, ISIN, or WKN (e.g., 'Apple', 'US0378331005'). |
| `start_date` | string | No | Start date in DD.MM.YYYY format (e.g., '01.04.2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/finanzen/get-historical-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","query":"<string>","start_date":"<string>"}'
```

### Get index components

Get the components of a financial index (e.g., DAX, NASDAQ 100). Returns all constituent stocks with their current price and year-to-date percentage change. The index_slug accepts common index identifiers like 'dax', 'nasdaq_100', 'mdax', or an ISIN such as 'DE0008469008'. The full list of components is returned in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index_slug` | string | No | The slug or ISIN of the index (e.g., 'dax', 'nasdaq_100', 'mdax', 'DE0008469008'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/finanzen/get-index-components \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"index_slug":"<string>"}'
```

## Next steps

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