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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/energy-charts/`
**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 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/credits/energy-charts/get-cross-border-trading \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-day-ahead-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-intraday-prices-volume \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-market-values \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-public-power \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-public-power-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-spot-market-prices-chart \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/energy-charts/get-traffic-signal \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","postal_code":"<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.