Introduction

Electricity Maps API is your gateway to real-time, historical and forecasted electricity data worldwide.

• The Quick start section presents the necessary elements to make your first request.
• The Concepts and parameters section defines the parameters used in the API endpoints as well as key concepts about Electricity Maps data to keep in mind when ingesting data.
• The Guides and resources section lists additional resources such as links to Electricity Maps methodology webpage and whitepapers.
• The API Reference section lists the documentation for all endpoints.

Electricity Maps API includes:

• Electricity grid data including electricity mix, electricity flows, load and net load, carbon intensity, renewable energy share and carbon-free energy share.
• Electricity markets data including day-ahead electricity prices in Europe and day-ahead locational marginal prices in the US.

For each data type, several endpoints are supported:

• /past-range to query data over a past datetime range
• /past to query data for a past datetime
• /history to query data for the last 24 hours
• /latest to query the last data available (in real-time)
• /forecast to query Electricity Maps proprietary forecasts

For day-ahead prices, two additional endpoints are also available:

• /actual to query published prices indifferently in the past and in the future
• /combined to query forward-looking prices extending published prices with Electricity Maps proprietary forecasts

Keep reading to dig deeper on how to use our API and talk with Sales when you're ready to take it further.