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

# Yearly Auction Volumes

`GET /api/v2/Auction/Volumes/Yearly/ByArea`

Returns a list of auction volumes for a market, year and one area.
            
Note that this volume only reflect Nord Pool's part of the traded volume, not the market total volume.
            
            
### Response field descriptions
**yearlySummary**: 
 - **totalVolume**: contains total bought and sold MWh for the year
 - **averageVolume**: the average bought and sold MW across all delivery periods
 - **minVolume**: the minimum bought and sold MW across all delivery periods
 - **maxVolume**: the maximum bought and sold MW across all delivery periods
            
**monthlySummary**: a list of monthly aggregate values
 - **totalVolume**: contains total bought and sold MWh for the month
 - **averageVolume**: the average bought and sold MW across all delivery periods in the month
 - **minVolume**: the minimum bought and sold MW across all delivery periods in the month
 - **maxVolume**: the maximum bought and sold MW across all delivery periods in the month
            
**dailySummary**: a list of daily aggregate values
 - **totalVolume**: contains total bought and sold MWh for the day
 - **averageVolume**: the average bought and sold MW across all delivery periods in the day
 - **minVolume**: the minimum bought and sold MW across all delivery periods in the day
 - **maxVolume**: the maximum bought and sold MW across all delivery periods in the day

**blockVolumes**: a list of MWh buy and sell volumes for a period of the day.
            
**volumes**: a list of MW buy and sell volumes per delivery period

Only final volumes are included in this endpoint.

## Query parameters

- `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3', required
- `area` string, required
- `year` integer, required

## Response `200`

OK

- ApiAuctionYearlyVolume
  - `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3'
  - `deliveryArea` string, nullable, required
  - `year` integer
  - `status` 'Missing' | 'Preliminary' | 'Final' | 'Cancelled'
  - `blockVolumeUnit` string, nullable
  - `blockVolumes` BlockVolumeAggregate[], nullable
    - `blockName` string, nullable
    - `blockStart` string, date-time
    - `blockEnd` string, date-time
    - `buy` number, double, nullable
    - `sell` number, double, nullable
  - `unit` string, nullable
  - `volumes` AuctionsVolumeEntry[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `buy` number, double
    - `sell` number, double
  - `totalVolumeUnit` string, nullable
  - `yearlySummary` VolumeSummary
    - `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
  - `monthlySummaries` VolumeMonthlySummary[], 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
    - `deliveryDateStartCET` string, date
    - `deliveryDateEndCET` string, date
  - `dailySummaries` VolumeDailySummary[], 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
    - `deliveryDateCET` string, date
  - `updatedAt` string, date-time

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