---
title: "Intraday Trades By Trade Time"
method: GET
path: "/api/v2/Intraday/Trades/ByTradeTime"
tags: ["Intraday"]
---

# Intraday Trades By Trade Time

`GET /api/v2/Intraday/Trades/ByTradeTime`

Returns intraday contracts with trades, where trades have a trade time in between tradeTimeFrom - tradeTimeTo and at least one leg in 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.
            
**Note**: The time difference between tradeTimeFrom and tradeTimeTo cannot exceed **12** hours.
This limitation was introduced for performance reasons to restrict the response size.
During periods of high load on the system, responses may take longer than expected.
In such situations, it is recommended to query data in hourly intervals, for example
tradeTimeFrom=2025-04-01T**01:00:00**Z and tradeTimeTo=2025-04-01T**02:00:00**Z.

### Response field descriptions
            
**contracts**: a list of contracts to which these trades belong 

Each contract contains:
- **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 that have an updated time between updated time from and updated time to 

  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, trade time from 2025-05-05T00:30:00Z and trade time to 2025-05-05T01:54:00Z](https://proddataservicespublic.blob.core.windows.net/public-api-response-samples/Intraday/get_api_v2_Intraday_Trades_ByTradeTime.json)

## Query parameters

- `areas` string, required
- `tradeTimeFrom` string, date-time, required
- `tradeTimeTo` string, date-time, required

## Response `200`

OK

- ApiIntradayContainer
  - `volumeUnit` string, nullable
  - `contracts` PublicIntradayTradeContract[], nullable
    - `contractId` string, nullable
    - `contractName` string, nullable
    - `priceUnit` string, nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `trades` PublicIntradayTrade[], nullable
      - `tradeId` string, nullable
      - `tradeTime` string, date-time
      - `tradeUpdatedAt` string, date-time
      - `tradeState` 'None' | 'Completed' | 'Disputed' | 'NotCancelled' | 'Cancelled'
      - `revisionNumber` integer
      - `price` number, double
      - `volume` number, double
      - `tradePhase` 'Unknown' | 'Continuous' | 'Auction'
      - `crossPx` boolean
      - `legs` PublicIntradayTradeLeg[], nullable
        - `deliveryArea` string, nullable
        - `referenceOrderId` string, nullable
        - `tradeSide` 'None' | 'Buy' | 'Sell'

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/nordpoolgroup/apis/auction-member-test.md) · [All operations](https://skmtc.net/nordpoolgroup/apis/auction-member-test/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nordpoolgroup/auction-member-test/versions/6a21504d677e/schema)