# Nordpoolgroup — 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 Nord Pool electricity market data including day-ahead prices, system prices, intraday statistics, and market areas across different regions. Access real-time and recent historical pricing information to track energy market trends and make informed decisions about electricity trading and consumption.

**Category:** Finance & Markets | **Website:** [data.nordpoolgroup.com/](https://data.nordpoolgroup.com/) | **Docs:** [parse.bot/marketplace/8800a9f9-fba4-4c5b-badc-ee3daff601aa/data-nordpoolgroup-com-api](https://parse.bot/marketplace/8800a9f9-fba4-4c5b-badc-ee3daff601aa/data-nordpoolgroup-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-data-nordpoolgroup-com-api-8800a9f9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_day_ahead_indices

Fetch day-ahead price indices for a specific date and area. Returns index entries (price per area) at configurable resolution (default 15 minutes). Useful for retrieving peak/base price index data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Area code or index name (e.g. AT, NO1, SE1, FI) |
| `currency` | string | No | Currency code |
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today. |
| `market` | string | No | Market name |
| `resolution` | integer | No | Resolution in minutes (15 or 60) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-nordpoolgroup-com-api-8800a9f9/get_day_ahead_indices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","currency":"<string>","date":"<string>","market":"<string>","resolution":"<integer>"}'
```

### get_day_ahead_prices

Fetch day-ahead electricity prices for a specific date and market area. Returns 15-minute interval prices with per-area values, block price aggregates (Peak, Off-peak 1, Off-peak 2), and area averages. Defaults to today's date if not specified. Data availability is typically recent (~12 days).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Delivery area code (e.g. NO1, SE1, AT, FI, DK1, DK2, EE, LT, LV, DE-LU) |
| `currency` | string | No | Currency for price display (EUR, NOK, SEK, DKK, GBP) |
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today. |
| `market` | string | No | Market name (e.g. DayAhead) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-nordpoolgroup-com-api-8800a9f9/get_day_ahead_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","currency":"<string>","date":"<string>","market":"<string>"}'
```

### get_hourly_prices_by_date_range

Fetch day-ahead electricity price data for a range of dates. Calls the day-ahead prices endpoint for each day in the range. Maximum range is 31 days. Returns an array of daily results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Delivery area code |
| `currency` | string | No | Currency code |
| `end_date` | string | Yes | End date in YYYY-MM-DD format |
| `market` | string | No | Market name |
| `start_date` | string | Yes | Start date in YYYY-MM-DD format |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-nordpoolgroup-com-api-8800a9f9/get_hourly_prices_by_date_range \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","currency":"<string>","end_date":"<string>","market":"<string>","start_date":"<string>"}'
```

### get_intraday_stats

Fetch intraday market statistics and hourly trade data for an area. Returns OHLC prices (open, high, low, close), volumes (total, buy, sell), and trade times for each delivery hour.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area` | string | No | Delivery area code (e.g. AT, NO1, SE1, FI) |
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-nordpoolgroup-com-api-8800a9f9/get_intraday_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":"<string>","date":"<string>"}'
```

### get_market_areas

Retrieve the full list of market areas, their codes, regions, and currency support. Returns all available markets with their trading areas and valid date ranges. Useful for discovering valid area codes and currencies for other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-nordpoolgroup-com-api-8800a9f9/get_market_areas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_system_price

Fetch the Nord Pool system price (reference market clearing price) for a date. Returns 15-minute interval system prices with turnover data and block aggregates (Peak, Off-peak 1, Off-peak 2). The system price is the unconstrained equilibrium price before area splitting.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency code (EUR, NOK, SEK, DKK, GBP) |
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-data-nordpoolgroup-com-api-8800a9f9/get_system_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","date":"<string>"}'
```
