# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-finanzen-net-api-a3c12eb5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-finanzen-net-api-a3c12eb5/get_current_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-finanzen-net-api-a3c12eb5/get_historical_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-finanzen-net-api-a3c12eb5/get_index_components \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index_slug":"<string>"}'
```