v1

latestOpenAPI 3.1.02026-07-2694207444.7 KB
Intraday

Intraday Yearly Contract Statistics

Returns intraday contract statistics for a year and one area.

All intraday trades where at least one leg (buy or/and sell) belongs to Nord Pool, Independent Bulgarian Energy Exchange (IBEX) or Bursa Română de Mărfuri S.A (BRM) and one leg belongs to queried area are included in the calculation of contract statistics. However, trades where both legs belong to other PXs are excluded from the statistics. The calculation includes local and SIDC trades, as well as block trades and wash trades (trades where the same legal entity is on both the buy and sell sides).

This aggregate is updated once per day, and includes data up until yesterday (CET).

Response field descriptions

  • status: Missing if no data found for the year and area. Available if data is present
  • priceUnit: defines the unit for all prices. Given as either EUR/MWh or GBP/MWh
  • contracts: a list of contracts for this delivery year
    • deliveryStart: delivery start time for the contract
    • deliveryEnd: delivery end time for the contract
    • isLocalContract: false if the contract is provided by XBID / SIDC, true if this contract is provided outside XBID / SIDC
    • contractId: the id of the contract
    • contractName: the name of the contract
    • contractOpenTime: the time the contract opens for trading
    • contractCloseTime: the time the contract closes for trading
    • highPrice: the highest trade price observed in the contract and area
    • lowPrice: the lowest trade price observed in the contract and area
    • openPrice: the price of the first trade in the contract and area
    • openTradeTime: the timestamp of the first trade in the area
    • closePrice: the price of the last observed trade in the contract and area. Note that if the contract is still open, this might change
    • closeTradeTime: the timestamp of the last observed trade in the area
    • averagePrice: the volume weighted average price for all trades observed in the contract and area
    • volume: the transaction volume of the contract and area given in MW
    • buyVolume: total buy volume in the area across all transactions given in MW
    • sellVolume: total sell volume in the area across all transactions given in MW
    • averagePriceLast3H: volume weighted average price for all trades happening within 3 hours of contract closing
    • averagePriceLast1H: volume weighted average price for all trades happening within 1 hour of contact closing

For a detailed breakdown on calculation rules, see <a href="https://developers.nordpoolgroup.com/reference/how-to-calculate-intraday-contract-statistics"> this page</a>.

Sample response with valid data for area NO1 and year 2021

get/api/v2/Intraday/ContractStatistics/Yearly/ByArea

Query parameters

areastring required

One area. For example NO1. Supported: KT(legacy),NO1,NO2,NO3,NO4,NO5,SE1,SE2,SE3,SE4,FI,DK1,DK2,EE,LT,LV,AT,BE,FR,GER,50Hz,AMP,TTG,TBW,NL,PL,TEL,BG,UK

yearinteger required

Year in CET (format: yyyy, e.g., 2024)

Response

OK

deliveryAreastring nullable
yearinteger
status'Missing' | 'Available'
priceUnitstring nullable required
volumeUnitstring nullable
updatedAtstring date-time