Big Imbalance
RTE documentation
The RTE documentation is available here.
What this API collects
The imbalance perimeter of a balance responsible party: energy bought and sold on the markets, flexibility, demand response, ARENH, imports and exports, imbalances and the amounts they are settled at.
Two reports are collected on every run, and both feed the same variables:
- the detail report, one entry per component of the perimeter;
- the summary report, the aggregated positions and settlement amounts.
Warning
RTE offers this API in two versions. Insights only supports V2.
The resolution follows the imbalance settlement period, which moved to 15 minutes on 2025-01-01. The switch is decided per day of data.
Insights configuration
Source
Create one source per EIC, as described in Source configuration.
| Property | Value |
|---|---|
| Source type | Rte |
| Meter number | The EIC code |
Variables
| Property | Value |
|---|---|
| Name | Free text |
| Variable type | Basic |
| Mapping config | See Mapping config |
| Granularity | 30 minutes before 2025-01-01, 15 minutes from 2025-01-01 |
| Quantity type | Instant |
| Unit | Depends on the data type — see {unitName} |
Mapping config
BIG-IMBALANCE_{dataType}_{invoicingTerm}_{resolution}_{unitName}
{dataType}
| Value | Meaning |
|---|---|
Y23 |
Distribution operator flexibility, upwards |
Y25 |
Distribution operator flexibility, downwards |
Y12 |
Futures exchange, purchase |
Y13 |
Futures exchange, sale |
Y14 |
Epex spot, purchase |
Y15 |
Epex spot, sale |
Y16 |
Nordpool spot, purchase |
Y17 |
Nordpool spot, sale |
Y18 |
Epex intraday, purchase |
Y19 |
Epex intraday, sale |
Y20 |
Nordpool intraday, purchase |
Y21 |
Nordpool intraday, sale |
Y22 |
Corrected demand response, demand response operator |
Y24 |
Regulated demand response, demand response operator |
Y28 |
Profiled demand response, demand response operator |
Z87 |
Block exchange programme, purchase |
Z88 |
Block exchange programme, sale |
Z69 |
Block exchange programme, site sale |
Z89 |
Import |
Z90 |
Export |
Z91 |
ARENH purchase |
Z92 |
ARENH sale |
A15 |
Losses |
Z93 |
Positive cross-border deviations, non-identified |
Z94 |
Negative cross-border deviations, non-identified |
Z95 |
FCR reserve, upwards |
Z96 |
FCR reserve, downwards |
Z97 |
aFRR reserve, upwards |
Z98 |
aFRR reserve, downwards |
Z99 |
Balancing mechanism, upwards |
Y01 |
Balancing mechanism, downwards |
Z54 |
Negative balance group correction, distribution operators |
Z55 |
Positive balance group correction, distribution operators |
Y02 |
Exchange purchase |
Y03 |
Exchange sale |
Y04 |
Demand response, demand response operator |
Y05 |
Demand response, curtailed party |
Y06 |
Production, transmission network |
Y07 |
Consumption, transmission network |
Z59 |
Positive deviation |
Z60 |
Negative deviation |
B20 |
Imbalance price, positive |
B21 |
Imbalance price, negative |
Z62 |
Positive amount |
Z63 |
Negative amount |
Y08 |
Physical production |
Z58 |
Purchases |
Y09 |
Physical consumption |
Z57 |
Sales |
Y10 |
Upward correction |
Y11 |
Downward correction |
Z64 |
Deviation |
Z61 |
Valued deviation |
{invoicingTerm}
| Value | Meaning |
|---|---|
P1M |
Invoiced at M+1 |
P3M |
Invoiced at M+3 |
P6M |
Invoiced at M+6 |
P12M |
Invoiced at M+12 |
RT |
Settled in real time |
NA |
Term not provided, or not one of the values above |
{resolution}
| Value | Applies to |
|---|---|
PT30M |
Days before 2025-01-01 |
PT15M |
Days on or after 2025-01-01 |
Note
These are the two resolutions Insights requests. The segment is written from the resolution echoed back in the response, so a data type that RTE publishes at a coarser step carries that step instead.
{unitName}
The unit depends on the data type: an energy is published in MWH, a price in EUR/MWH, an amount in EUR.
Set the Unit of the variable to match the segment.
Examples
BIG-IMBALANCE_Z55_P1M_PT30M_MWH
BIG-IMBALANCE_B20_P12M_PT30M_EUR/MWH
BIG-IMBALANCE_Y01_NA_PT15M_MWH
Collection schedule
Once a day, at 07:30 UTC.
Recovery behaviour
Gap filling over the last 31 days: a day is queried only when one of the BIG-IMBALANCE_* variables has no data
for it. Both reports are then collected for that day.
Perimeter check
This API does not check the referential before calling RTE. A point outside the perimeter returns an empty response rather than a skip in the log. Use Id Referential to confirm eligibility when a source stays empty.