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

# Yearly Auction Prices

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

Returns a list of auction prices for a market, currency, year and one area.
            
### Response field descriptions
- **prices**: the settlement price for each period. If no trading happens, then the price might be null
- **blockPrices**: average price for a periods of the day, called blocks.
- **dailySummaries**: contains min, max and average price for each day in the year
- **monthlySummaries**: contains min, max and average price for each month of the year
- **weeklySummaries**: contains min, max and average price for each week of the year. Note this can include date ranges outside the actual year, since weeks do not align nicely with the yearly calendar.
- **yearlySummary**: min, max and average price for the full year.
  
 Only final prices 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
- `currency` string, required
- `year` integer, required

## Response `200`

OK

- ApiAuctionYearlyPrice
  - `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'
  - `unit` string, nullable, required
  - `currency` string, nullable, required
  - `marketMainCurrency` string, nullable, required
  - `blockPrices` BlockPriceAggregate[], nullable
    - `blockName` string, nullable
    - `blockStart` string, date-time
    - `blockEnd` string, date-time
    - `minPrice` number, double, nullable
    - `maxPrice` number, double, nullable
    - `averagePrice` number, double, nullable
  - `prices` PriceEntry[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `price` number, double, nullable
  - `yearlySummary` Summary
    - `averagePrice` number, double, nullable
    - `minPrice` number, double, nullable
    - `maxPrice` number, double, nullable
  - `dailySummaries` SummaryPrice[], nullable
    - `averagePrice` number, double, nullable
    - `minPrice` number, double, nullable
    - `maxPrice` number, double, nullable
    - `deliveryDateCET` string, date
  - `weeklySummaries` WeeklyPriceSummary[], nullable
    - `averagePrice` number, double, nullable
    - `minPrice` number, double, nullable
    - `maxPrice` number, double, nullable
    - `isoWeekNumber` integer
    - `deliveryDateStartCET` string, date
    - `deliveryDateEndCET` string, date
  - `monthlySummaries` MonthlyPriceSummary[], nullable
    - `averagePrice` number, double, nullable
    - `minPrice` number, double, nullable
    - `maxPrice` number, double, nullable
    - `deliveryDateStartCET` string, date
    - `deliveryDateEndCET` 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/revisions/6a21504d677e/schema)