---
title: "Upcoming Trades"
method: GET
path: "/gb/national-grid/interconnectors/upcoming-trades"
tags: ["NESO"]
---

# Upcoming Trades

`GET /gb/national-grid/interconnectors/upcoming-trades`

This dataset displays all upcoming GTMA (Grid Trade Master Agreement) trades due to be delivered on the National Grid ESO network. This is in order to meet forecast. This data is provisional and subject to correction.

## Query parameters

- `date_from` string, date, required
- `date_to` string, date, required
- `limit` integer
- `offset` integer
- `timezone` 'UTC' | 'Europe/Berlin' | 'Europe/London' | 'America/New_York' | 'America/Chicago' | 'America/Los_Angeles'

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` SOUT[], required
    - `tradeId` string, nullable
    - `settlementDate` string, date, required
    - `settlementPeriod` integer, nullable
    - `volume` number, nullable
    - `price` number, nullable
    - `cost` number, nullable
    - `soFlag` string, nullable
    - `reason` string, nullable
    - `note` string, nullable
    - `lastUpdated` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/modoenergy/apis/modo-energy-api.md) · [All operations](https://skmtc.net/modoenergy/apis/modo-energy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modoenergy/modo-energy-api/revisions/6c4b83d3fc12/schema)