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

> Access real-time and historical European energy market data including natural gas spot and futures prices, German power futures, and intraday power information. Monitor market snapshots and Guarantees of Origin to stay informed on energy market movements across Europe.

**Category:** Finance & Markets | **Website:** [powernext.com/](https://powernext.com/) | **Docs:** [parse.bot/marketplace/90c40af9-ee66-4d16-abfc-e6634a20c9f0/powernext-com-api](https://parse.bot/marketplace/90c40af9-ee66-4d16-abfc-e6634a20c9f0/powernext-com-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/powernext/`
**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 guarantees of origin

Extract Guarantees of Origin (GO) data for Renewable Power (EGOE instrument). Returns the last 30 days of trading data for the current year maturity. Values may be null on non-trading days or when no settlement has occurred.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/powernext/get-guarantees-of-origin \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get historical spot prices

Fetch historical Natural Gas Spot Day-Ahead prices for a specified hub and date range. When start_date and end_date are omitted, defaults to the last 30 days. Useful for trend analysis and backtesting over arbitrary windows.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date in YYYY-MM-DD format. Omitting returns last 30 days. |
| `hub` | string | No | Hub short name for the gas trading hub. |
| `start_date` | string | No | Start date in YYYY-MM-DD format. Omitting returns last 30 days. |

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

### Get intraday power data

Retrieve intraday power market data proxy via EEX Power Day Futures (DB01) for the German area. Returns the last 3 days of trading data. Values may be null when the maturity date is in the future and no settlement has occurred yet.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/powernext/get-intraday-power-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market data hub snapshot

Fetch the current market data price ticker snapshot for key Natural Gas spot indicators (TTF, THE, CEGH VTP). Returns the latest settlement price, price change, and instrument metadata for each hub. Useful for dashboards and real-time monitoring.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/powernext/get-market-data-hub-snapshot \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get natural gas futures prices

Extract Natural Gas Futures settlement prices (EUR/MWh) for the front month across TTF and THE hubs. Returns the last 7 days of trading data. Each record includes instrument code, maturity date, trade date, settlement price, volume, open interest, unit of measure, and currency. Values may be null on non-trading days.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/powernext/get-natural-gas-futures-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get natural gas spot prices

Extract Natural Gas Spot market Day-Ahead prices (EUR/MWh) across European hubs (TTF, THE, CEGH VTP, PEG). Returns the last 7 days of trading data. Each record includes the instrument short code, trade date, settlement price, delivery day, total volume traded, unit of measure, and currency.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/powernext/get-natural-gas-spot-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get power futures prices

Retrieve German (DE) power futures prices (Base) for Year, Month, and Day maturities. Returns the last 7 days of trading data. Each record includes instrument code, maturity date, trade date, settlement price, volume, gross open interest, unit of measure, and currency.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/powernext/get-power-futures-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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