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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-powernext-com-api-90c40af9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-powernext-com-api-90c40af9/get_guarantees_of_origin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-powernext-com-api-90c40af9/get_historical_spot_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-powernext-com-api-90c40af9/get_intraday_power_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-powernext-com-api-90c40af9/get_market_data_hub_snapshot \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-powernext-com-api-90c40af9/get_natural_gas_futures_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-powernext-com-api-90c40af9/get_natural_gas_spot_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-powernext-com-api-90c40af9/get_power_futures_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```