Imbalance - Engrate Developer Documentation

{
  "clearing_period_uid": "<string>",
  "daily_imbalances": [
    {
      "actual_mwh": 123,
      "date": "<string>",
      "imbalance_mwh": 123,
      "scheduled_mwh": 123
    }
  ],
  "total_actual_mwh": 123,
  "total_imbalance_cost_eur": 123,
  "total_imbalance_mwh": 123,
  "total_scheduled_mwh": 123
}

The imbalance response provides an aggregated view of the difference between scheduled and actual energy for an entire Clearing Period, broken down by day.

Calculation

For each day in the settlement month:

Scheduled energy — the total energy declared in your accepted schedules for that day
Actual energy — the total metered energy from MSCONS settlement data
Imbalance — actual minus scheduled (positive = actual exceeded scheduled, i.e. more consumption or less generation than declared)

The per-day imbalances are then aggregated to produce period-level totals.

Cost calculation

The total_imbalance_cost_eur field represents the financial impact of your imbalance, calculated using reBAP Control Energy Prices. Each quarter-hourly imbalance interval is multiplied by the corresponding reBAP price, then summed across the month.

Daily breakdown

The daily_imbalances array contains one DailyImbalance entry per day, each with:

Field	Description
`date`	Settlement date
`scheduled_mwh`	Total scheduled energy for this day
`actual_mwh`	Total actual (metered) energy for this day
`imbalance_mwh`	Difference (actual minus scheduled)

Aggregated imbalance calculation for an entire clearing period, broken down by day.

clearing_period_uid

string

required

Parent Clearing Period identifier.

daily_imbalances

DailyImbalance · object[]

required

Per-day imbalance breakdown.

Show child attributes

total_actual_mwh

number

required

Total actual energy across all days in MWh.

Example:

3732.5

total_imbalance_cost_eur

number

required

Total imbalance cost in EUR based on reBAP control energy prices.

Example:

1875

total_imbalance_mwh

number

required

Total net imbalance across all days in MWh.

Example:

12.5

total_scheduled_mwh

number

required

Total scheduled energy across all days in MWh.

Example:

3720

Energy Volume Control Energy Price

⌘I

​Calculation

​Cost calculation

​Daily breakdown

Calculation

Cost calculation

Daily breakdown