v1

latestOpenAPI 3.1.02026-07-2694207444.7 KB
Intraday

Intraday Trades By Contract

Returns an intraday contract with trades for a delivery start time and contract id, where trades have at least one leg matching at least one of the provided areas.

All trades have at least one leg belongs to Nord Pool. However, trades where both legs belong to other PXs are excluded from the response.

Data is available with a delay of approximately 20 minutes.

Response field descriptions

  • contractId: identifier of the contract

  • contractName: a descriptive name for the contract (e.g., QH-20250331-09).

  • deliveryStart: the timestamp when the contract delivery starts

  • deliveryEnd: the timestamp when the contract delivery ends

  • trades: a list of trades associated with the contract

    Each trade includes:

    • tradeId: identifier of the trade

    • tradeTime: the timestamp of trade creation

    • tradeUpdatedAt: the trade creation time (revisionNumber=1) or time of a trade modification (revisionNumber>1)

    • tradeState:

      • Completed - the trade is completed
      • Cancelled - the trade is cancelled
      • Disputed - the trade is pending decision for cancellation
    • revisionNumber: revision number for trade modification request. Should be incremented with a subsequent trade modification request.

    • price: price in EUR/MWh or GBP/MWh

    • volume: quantity in MW

    • tradePhase: there's two matching modes:

      • Continuous - the normal top of order book matching
      • Auction - the matching mode, where basically the buy and sell orders are matched in a similar manner as auction orders. This only happens when capacity is added in between areas - basically, in that case, the order books can be overlapping with buys in one area being much higher than sells in another area. In order for the price to be fair for both the sellers and buyers, this auction matching mode is used.
      • None - for old trades without this information
    • crossPx:

      • false: both legs belong to the Nord Pool market
      • true: one of the legs belongs to Other Power Exchanges (OPX). Then the trade contains "referenceOrderId" only for the side which is presented in Nord Pool, the other side doesn't have reference order id ("referenceOrderId": null).
    • legs: a list of trade legs

      Each leg contains:

      • deliveryArea: delivery area that this order belongs to

      • referenceOrderId: identifier of the order involved in the trade. In transactions where one party is external to Nord Pool, the referenceOrderId will be null for the leg that belongs to OPX.

      • tradeSide: Buy or Sell

Sample response with valid data for areas NO1,AMP, delivery start 2025-05-05T01:00:00Z and contract id NX_519789

get/api/v2/Intraday/Trades/ByContractId

Query parameters

areasstring required

Comma-separated list of areas (e.g., NO1, NO2). Supported: KT(legacy),NO1,NO2,NO3,NO4,NO5,SE1,SE2,SE3,SE4,FI,DK1,DK2,EE,LT,LV,AT,BE,FR,50Hz,AMP,TTG,TBW,NL,PL,TEL,BG,UK

deliveryStartstring date-time required

Delivery start time of the contract, referring to a UTC datetime. Format yyyy-MM-ddThh:mm:ssZ, for example 2024-08-15T01:00:00Z

contractIdstring required

The contract id

Response

OK

contractIdstring nullable
contractNamestring nullable
priceUnitstring nullable
deliveryStartstring date-time
deliveryEndstring date-time
volumeUnitstring nullable