Past range

get
/v4/price-day-ahead/past-range

Get the day-ahead price for a zone and a given datetime range.

The time range is limited to 10 days (240 hours) for an hourly granularity, and to 100 days for a daily granularity. If you need more data, you can loop over time ranges.

Query Parameters

zone optional

An Electricity Maps zone key.

Example: "DK-DK2"
start required

The start datetime to get the data for.

Format: ISO 8601 datetime
Example: "2024-05-19T03:00:00Z"
end required

The end datetime to get the data for.

Format: ISO 8601 datetime
Example: "2024-05-19T08:00:00Z"
temporalGranularity optional

The temporal granularity of the data to get.

Default: "hourly"
One of: "5_minutes", "15_minutes", "hourly", "daily", "monthly", "quarterly", "yearly"
lat optional

Latitude of the location to get the data for.

Example: 41.877
lon optional

Longitude of the location to get the data for.

Example: -88.0703
disableCallerLookup optional

If true, the fallback IP-based zone lookup will not be performed.

Default: false
disableEstimations optional

If true, the response will exclude estimated data points

Default: false
emissionFactorType optional

The type of emission factors to use.

Default: "lifecycle"
One of: "direct", "lifecycle"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v4/price-day-ahead/past-range?start=2024-05-19T03%3A00%3A00Z&end=2024-05-19T08%3A00%3A00Z"
{  "zone": "string",  "data": [    {      "zone": "DK-DK2",      "datetime": "2024-05-19T03:00:00.000Z",      "createdAt": "2024-05-16T03:48:50.419Z",      "updatedAt": "2025-07-25T12:32:42.039Z",      "value": 100,      "unit": "EUR/MWh",      "source": "settled_and_published_price",      "temporalGranularity": "hourly"    }  ],  "temporalGranularity": "hourly",  "aggregationPeriod": "hourly"}

Playground

get
/v4/price-day-ahead/past-range
Explore the API with a 14-day trial.