---
title: "Auction Volumes"
method: GET
path: "/api/v2/Auction/Volumes/ByAreas"
tags: ["Auction"]
---

# Auction Volumes

`GET /api/v2/Auction/Volumes/ByAreas`

Returns a list of auction volumes for a market, date and list of areas.
            
Note that this volume only reflect Nord Pool's part of the traded volume, not the market total volume.
            
### Response field descriptions
- **status**: Missing if data does not exist. Preliminary if the market coupling session is not complete. Final once the market coupling session is complete. Cancelled if the auction is cancelled.
            
**totalVolume**
- **buy**: total MWh bought in the area across all delivery periods
- **sell**: total MWh sold in the area across all delivery periods
            
**averageVolume**
- **buy**: average MW of bought volume across all delivery periods
- **sell**: average MW of sold volume across all delivery periods
            
**minVolume**
- **buy**: minimum MW bought across all delivery periods
- **sell**: minimum MW sold across all delivery periods
            
**maxVolume**
- **buy**: maximum MW bought across all delivery periods
- **sell**: maximum MW sold across all delivery periods
            
**blockVolumes**: List of MWh buy and sell volumes for a period of the day.
            
**volumes**: List of MW buy and sell volumes per delivery period

## Query parameters

- `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3', required
- `areas` string, required
- `date` string, date, required

## Response `200`

OK

- ApiAuctionVolume[]
  - `deliveryDateCET` string, date
  - `updatedAt` string, date-time
  - `deliveryArea` string, nullable, required
  - `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3'
  - `status` 'Missing' | 'Preliminary' | 'Final' | 'Cancelled'
  - `unit` string, nullable
  - `totalVolumeUnit` string, nullable
  - `totalVolume` VolumeAggregate
    - `buy` number, double, nullable
    - `sell` number, double, nullable
  - `averageVolume` VolumeAggregate
    - `buy` number, double, nullable
    - `sell` number, double, nullable
  - `minVolume` VolumeAggregate
    - `buy` number, double, nullable
    - `sell` number, double, nullable
  - `maxVolume` VolumeAggregate
    - `buy` number, double, nullable
    - `sell` number, double, nullable
  - `blockVolumesUnit` string, nullable
  - `blockVolumes` BlockVolumeAggregate[], nullable
    - `blockName` string, nullable
    - `blockStart` string, date-time
    - `blockEnd` string, date-time
    - `buy` number, double, nullable
    - `sell` number, double, nullable
  - `volumes` AuctionsVolumeEntry[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `buy` number, double
    - `sell` number, double

## 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/revisions/6a21504d677e/schema)