Skip to contents

Imbalance prices of the control area.

Usage

imbalance_prices(
  eic = NULL,
  period_start = ymd(Sys.Date() - days(x = 7L), tz = "CET"),
  period_end = ymd(Sys.Date(), tz = "CET"),
  tidy_output = TRUE,
  security_token = Sys.getenv("ENTSOE_PAT")
)

Arguments

eic

Energy Identification Code of the control area domain

period_start

POSIXct or YYYY-MM-DD HH:MM:SS format One year range limit applies

period_end

POSIXct or YYYY-MM-DD HH:MM:SS format One year range limit applies

tidy_output

Defaults to TRUE. flatten nested tables

security_token

Security token for ENTSO-E transparency platform

Value

A tibble::tibble() with the queried data.

Examples

df <- entsoeapi::imbalance_prices(
  eic = "10YCZ-CEPS-----N",
  period_start = lubridate::ymd(x = "2024-01-01", tz = "CET"),
  period_end = lubridate::ymd(x = "2024-01-02", tz = "CET"),
  tidy_output = TRUE
)
#> 
#> ── API call ────────────────────────────────────────────────────────────────────────────────────────────────────────────
#> → https://web-api.tp.entsoe.eu/api?documentType=A85&controlArea_Domain=10YCZ-CEPS-----N&periodStart=202312312300&periodEnd=202401012300&securityToken=<...>
#> <- HTTP/2 200 
#> <- date: Mon, 13 Apr 2026 08:51:48 GMT
#> <- content-type: application/zip
#> <- content-length: 1564
#> <- content-disposition: attachment; filename="Imbalance Prices_202312312300-202401012300.zip"
#> <- x-content-type-options: nosniff
#> <- x-xss-protection: 0
#> <- strict-transport-security: max-age=15724800; includeSubDomains
#> <- 
#>  response has arrived
#>  /tmp/RtmpB1aCB1/001-IMBALANCE_PRICES_R3_202312312300-202401012300.xml has been read in
#>  Additional type names have been added!
#>  Additional eic names have been added!
#>  Additional definitions have been added!

dplyr::glimpse(df)
#> Rows: 72
#> Columns: 25
#> $ area_domain_mrid                    <chr> "10YCZ-CEPS-----N", "10YCZ-CEPS-----N", "10YCZ-CEPS-----N", "10YCZ-CEPS---…
#> $ area_domain_name                    <chr> "Czech Republic", "Czech Republic", "Czech Republic", "Czech Republic", "C…
#> $ doc_status_value                    <chr> "A02", "A02", "A02", "A02", "A02", "A02", "A02", "A02", "A02", "A02", "A02…
#> $ doc_status                          <chr> "Allocated capacity schedule", "Allocated capacity schedule", "Allocated c…
#> $ type                                <chr> "A85", "A85", "A85", "A85", "A85", "A85", "A85", "A85", "A85", "A85", "A85…
#> $ type_def                            <chr> "Imbalance prices", "Imbalance prices", "Imbalance prices", "Imbalance pri…
#> $ process_type                        <chr> "A16", "A16", "A16", "A16", "A16", "A16", "A16", "A16", "A16", "A16", "A16…
#> $ process_type_def                    <chr> "Realised", "Realised", "Realised", "Realised", "Realised", "Realised", "R…
#> $ ts_business_type                    <chr> "A19", "A19", "A19", "A19", "A19", "A19", "A19", "A19", "A19", "A19", "A19…
#> $ ts_business_type_def                <chr> "Balance energy deviation", "Balance energy deviation", "Balance energy de…
#> $ created_date_time                   <dttm> 2026-04-13 08:51:48, 2026-04-13 08:51:48, 2026-04-13 08:51:48, 2026-04-13…
#> $ revision_number                     <dbl> 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
#> $ ts_resolution                       <chr> "PT60M", "PT60M", "PT60M", "PT60M", "PT60M", "PT60M", "PT60M", "PT60M", "P…
#> $ ts_time_interval_start              <dttm> 2023-12-31 23:00:00, 2023-12-31 23:00:00, 2023-12-31 23:00:00, 2023-12-31…
#> $ ts_time_interval_end                <dttm> 2024-01-01 23:00:00, 2024-01-01 23:00:00, 2024-01-01 23:00:00, 2024-01-01…
#> $ ts_mrid                             <dbl> 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
#> $ ts_point_dt_start                   <dttm> 2023-12-31 23:00:00, 2023-12-31 23:00:00, 2024-01-01 00:00:00, 2024-01-01…
#> $ imbalance_price_amount              <dbl> -911.63, -911.63, -491.43, -491.43, -1237.16, -1237.16, -1977.85, -1977.85…
#> $ financial_price_amount              <dbl> -709.83, 0.00, -35.73, 0.00, -697.36, 0.00, -687.15, 0.00, -376.95, 0.00, 
#> $ ts_currency_unit_name               <chr> "CZK", "CZK", "CZK", "CZK", "CZK", "CZK", "CZK", "CZK", "CZK", "CZK", "CZK…
#> $ ts_price_measure_unit_name          <chr> "MWH", "MWH", "MWH", "MWH", "MWH", "MWH", "MWH", "MWH", "MWH", "MWH", "MWH…
#> $ imbalance_price_category            <chr> "A04", "A04", "A04", "A04", "A04", "A04", "A04", "A04", "A04", "A04", "A04…
#> $ imbalance_price_category_def        <chr> "Excess balance", "Excess balance", "Excess balance", "Excess balance", "E…
#> $ financial_price_descriptor_type     <chr> "A02", "A03", "A02", "A03", "A02", "A03", "A02", "A03", "A02", "A03", "A02…
#> $ financial_price_descriptor_type_def <chr> "Incentive", "Financial neutrality", "Incentive", "Financial neutrality",