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

# Auction Volumes

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

## Request

- The document declares no server URL.
- Auth: OAuth 2
  - Authorization code: `https://sts.nordpoolgroup.com/connect/authorize`
  - Token URL: `https://sts.nordpoolgroup.com/connect/token`

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' | 'Iceland_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' | 'Iceland_DayAhead' | 'NP_IntradayAuction1' | 'NP_IntradayAuction2' | '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.dev/nordpoolgroup/apis/market-data-api.md) - [All operations](https://skmtc.dev/nordpoolgroup/apis/market-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nordpoolgroup/apis/market-data-api/revisions/95dc8f94afe7?raw)