---
title: "Market depth by settlement period (IMBALNGC, BOD, DISEBSP, DISPTAV)"
method: GET
path: "/balancing/settlement/market-depth/{settlementDate}/{settlementPeriod}"
tags: ["Indicative Imbalance Settlement"]
---

# Market depth by settlement period (IMBALNGC, BOD, DISEBSP, DISPTAV)

`GET /balancing/settlement/market-depth/{settlementDate}/{settlementPeriod}`

Returns market depth data for a given settlement period.
Imbalance (MW) is retrieved from IMBALNGC.
Bid/offer volumes (MWh) are calculated by summing bid/offer volumes from BOD.
Total acceptance volumes (MWh) are retrieved from DISEBSP.
Priced acceptance volumes (MWh) are calculated by summing bid/offer accepted volumes with data type Original from DISPTAV.
            
Settlement date parameter must be provided in the exact format yyyy-MM-dd.

## Path parameters

- `settlementPeriod` integer, required
- `settlementDate` string, date, required

## Query parameters

- `format` 'json' | 'xml' | 'csv'

## Response `200`

Data retrieved

- InsightsApiModelsResponsesResponseWithMetadata1InsightsApiModelsResponsesBalancingSettlementMarketDepthResponse
  - `data` InsightsApiModelsResponsesBalancingSettlementMarketDepthResponse[], nullable
    - `settlementDate` string, date
    - `settlementPeriod` integer
    - `indicatedImbalance` integer, nullable
    - `offerVolume` number, double, nullable
    - `bidVolume` number, double, nullable
    - `totalAcceptedOfferVolume` number, double, nullable
    - `totalAcceptedBidVolume` number, double, nullable
    - `pricedAcceptedOffersVolume` number, double, nullable
    - `pricedAcceptedBidsVolume` number, double, nullable
  - `metadata` InsightsApiModelsMetadataApiResponseSourceMetadata
    - `datasets` string[], nullable

## Other responses

- `400` — Error with query parameters - see response for details
- `429` — Too many requests
- `500` — Server error - please try again later

---

[API](https://skmtc.net/elexon/apis/bmrs-insights.md) · [All operations](https://skmtc.net/elexon/apis/bmrs-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elexon/bmrs-insights/revisions/d94e9edb295e/schema)