Timeseries names
How a timeseries is named, and every category with data today.
A timeseries is identified by its entity, its name and its provider. Names have three or four
parts, category.sub_category.definition[.component]:
consumption.realised_load.total_loadconsumption.load_forecast.day_ahead_total_load_forecastproduction.realised_output.actual_generation_per_type.wind_onshoreproduction.forecast.wind_generation_forecast.onshore_day_aheadprice.day_ahead.day_ahead_auction_priceexchange.physical_flow.physical_flow(on a border)exchange_capacity.ntc_atc.day_ahead_ntc(on a border)
A name exists only on the entities whose provider publishes it. day_ahead_ntc, for one, is on
the borders where capacity is allocated border by border; the flow-based borders of central
western Europe (border:AT~DE-LU, border:BE~FR, border:DE-LU~FR and their neighbours) have
no such series, because their capacity is computed for the region as a whole. List an entity's
names with GET /entities/{entity}/timeseries before asking for values.
| Part | Says | Example |
|---|---|---|
| category | the kind of quantity | production |
| sub-category | the kind of statement: a measured actual, a forecast, a plan, a market outcome | realised_output |
| definition | the precise quantity | actual_generation_per_type |
| component | one member of a breakdown: a production type, a direction, a reserve product | wind_onshore |
Categories
Every category, its sub-categories and the definitions with data today.
Data types
Besides its name, every timeseries has a data_type, derived from its category and sub-category,
that says what kind of value it holds. It is returned in every list and accepted as a filter by the
list and search calls, so a query for "the forecasts on this entity" needs no knowledge of the
sub-category names.
data_type | Holds | Example |
|---|---|---|
actual | measured or realised values | consumption.realised_load.total_load |
forecast | forecasts published by the provider | production.forecast.wind_generation_forecast.onshore_day_ahead |
price | market and settlement prices | price.day_ahead.day_ahead_auction_price |
capacity | installed, available and cross-border capacities | exchange_capacity.ntc_atc.day_ahead_ntc |
schedule | plans and scheduled exchanges | exchange.scheduled_commercial.commercial_exchange_schedule |
other | statistics and indicators | production.indicators_shares.renewable_share_of_generation |