# Energy Charts — 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.

> Monitor real-time electricity prices, production data, and market forecasts across Germany and Europe to track energy costs and grid conditions. Access day-ahead and intraday pricing, power generation forecasts, cross-border trading flows, and traffic signal alerts for comprehensive energy market insights.

**Category:** Finance & Markets | **Website:** [energy-charts.de/](https://energy-charts.de/) | **Docs:** [parse.bot/marketplace/a0a3fd69-d31f-4489-9435-1244a697c32a/energy-charts-de-api](https://parse.bot/marketplace/a0a3fd69-d31f-4489-9435-1244a697c32a/energy-charts-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-energy-charts-de-api-a0a3fd69/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cross_border_trading

Fetch cross-border electricity trading data (imports/exports) at 15-minute resolution. Returns trading flows with neighboring countries in GW (positive=export, negative=import) for the specified date range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code (e.g. de, at, fr). |
| `end` | string | No | End date in YYYY-MM-DD format. Defaults to the start date. |
| `start` | string | No | Start date in YYYY-MM-DD format. Defaults to today's date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_cross_border_trading \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","end":"<string>","start":"<string>"}'
```

### get_day_ahead_prices

Fetch Day-Ahead auction spot market prices at 15-minute resolution for a given bidding zone and date range. Returns timestamps, prices in EUR/MWh, and license attribution. Defaults to today when no dates are supplied.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bzn` | string | No | Bidding zone code. |
| `end` | string | No | End date in YYYY-MM-DD format. Defaults to the start date if omitted. |
| `start` | string | No | Start date in YYYY-MM-DD format. Defaults to today's date if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_day_ahead_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bzn":"<string>","end":"<string>","start":"<string>"}'
```

### get_intraday_prices_volume

Fetch intraday continuous average prices and trading volumes (hourly) from chart data files for Germany. Returns hourly price/volume pairs for the specified ISO week. Defaults to the current week if year/week are omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code. Only 'de' is reliably supported. |
| `week` | string | No | ISO week number (1-53). Defaults to current week. |
| `year` | string | No | Year in YYYY format. Defaults to current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_intraday_prices_volume \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","week":"<string>","year":"<string>"}'
```

### get_market_values

Fetch monthly technology-specific market values (capture prices) and feed-in tariffs from chart data files for Germany. Returns an array of chart series with monthly values in Cent/kWh for the specified year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code. Only 'de' is reliably supported. |
| `year` | string | No | Year in YYYY format. Defaults to current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_market_values \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","year":"<string>"}'
```

### get_public_power

Fetch public net electricity production by technology type (solar, wind, gas, coal, etc.) at 15-minute resolution for the specified date range and country. Defaults to today for Germany.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code (e.g. de, at, fr, ch). |
| `end` | string | No | End date in YYYY-MM-DD format. Defaults to the start date. |
| `start` | string | No | Start date in YYYY-MM-DD format. Defaults to today's date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_public_power \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","end":"<string>","start":"<string>"}'
```

### get_public_power_forecast

Fetch electricity production forecasts at 15-minute resolution for a given production type and forecast horizon. Returns timestamps and forecast power values in MW (may contain null for future periods not yet forecasted).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code (e.g. de, at, fr). |
| `forecast_type` | string | No | Forecast horizon type. |
| `production_type` | string | No | Production type to forecast. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_public_power_forecast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","forecast_type":"<string>","production_type":"<string>"}'
```

### get_spot_market_prices_chart

Fetch granular spot market price data (15-min resolution) including production by type, IDA auction prices, and intraday prices from chart data files for Germany. Returns the full Highcharts series array for the specified ISO week.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code. Only 'de' is reliably supported. |
| `week` | string | No | ISO week number (1-53). Defaults to current week. |
| `year` | string | No | Year in YYYY format. Defaults to current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_spot_market_prices_chart \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","week":"<string>","year":"<string>"}'
```

### get_traffic_signal

Fetch renewable energy share and traffic signal data. The signal indicates whether renewable generation is high (2=green), medium (1=yellow), or low (0=red) relative to load. An optional postal code narrows the signal to a local grid area.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code (e.g. de). |
| `postal_code` | string | No | Optional German postal code for local grid state (e.g. 10115). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-energy-charts-de-api-a0a3fd69/get_traffic_signal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","postal_code":"<string>"}'
```