---
title: "Live NIV"
method: GET
path: "/gb/modo/markets/niv-live"
tags: ["Live Balancing Mechanism"]
deprecated: true
---

# Live NIV

`GET /gb/modo/markets/niv-live`

> **Deprecated.**

Modo Energy's live calculation of net imbalance volume (NIV). This is the volume sum of all balancing actions taken by National Grid ESO in the Balancing Mechanism for each settlement period. For the current settlement period, this dataset represents all the actions taken so far by National Grid ESO, and is not a forecast for the end of the settlement period. This endpoint is deprecated, and any missing data will not be backfilled.

## Query parameters

- `date_from` string, date, required
- `date_to` string, date, required
- `limit` integer
- `offset` integer

## Response `200`

Success

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` MarketScreens[], required
    - `id` integer
    - `bmu_id` string, required
    - `boa_id` integer, required
    - `timestamp` string, date-time, nullable
    - `date` string, date, required
    - `settlement_period` integer, required
    - `pair_id` number, nullable
    - `boa_type` string, required
    - `action_type` string, required
    - `so_flag` boolean, required
    - `stor_flag` boolean, required
    - `cadl_flag` boolean, required
    - `acceptance_time` string, date-time, nullable
    - `from_time` string, date-time, nullable
    - `to_time` string, date-time, nullable
    - `volume` number, required
    - `price` number, required
    - `first_stage_flag` boolean, required
    - `second_stage_flag` boolean, required
    - `repriced_indicator` boolean, required
    - `stor_adjusted_price` number, required
    - `dmat_adjusted_volume` number, required
    - `arbitrage_adjusted_volume` number, required
    - `niv_adjusted_volume` number, required
    - `replacement_price` number, required
    - `par_adjusted_volume` number, required
    - `transmission_loss_multiplier` number, required
    - `fuel_type` 'SUPPLIER' | 'BATTERY' | 'CCGT' | 'OTHER' | 'WIND' | 'BIOMASS' | 'HYDRO' | 'OCGT' | 'INTERCONNECTOR' | 'CASCADE_HYDRO' | 'SOLAR' | 'PS' | 'NUCLEAR' | 'COAL' | 'VIRTUAL' | 'UNKNOWN' | 'GAS', 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/versions/6c4b83d3fc12/schema)