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

# Auction Prices

`GET /api/v2/Auction/Prices/ByAreas`

Returns a list of auction prices for a market, currency, date and list of areas.
### Response field descriptions
- **status**: Missing if data does not exist. Preliminary if the market coupling session is not complete, or the exchange rate has not been finalized yet. Final once exchange rate is set and market coupling session is complete. Cancelled if the auction is cancelled.
- **exchangeRate**: the exchange rate used to calculate the currency price. 1 if the currency is the same as the main market currency.
- **prices**: the settlement price for each period. If no trading happens, then the price might be null
- **blockPrices**: average price for periods (block) of the day
            
Note that settlement will only be done for Final prices - preliminary prices can change either due to updated exchange rate, or in rare cases from a re-opening of order books and re-calculating prices.
            
Preliminary prices can change, and exchange rates for local currencies are only finalized on Norwegian banking days.

## Query parameters

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

## Response `200`

OK

- ApiAuctionPrice[]
  - `deliveryDateCET` string, date
  - `updatedAt` string, date-time
  - `status` 'Missing' | 'Preliminary' | 'Final' | 'Cancelled'
  - `unit` string, nullable
  - `currency` string, nullable, required
  - `exchangeRate` number, double, nullable
  - `marketMainCurrency` string, nullable, required
  - `averagePrice` number, double, nullable
  - `minPrice` number, double, nullable
  - `maxPrice` number, double, nullable
  - `prices` PriceEntry[], nullable
    - `deliveryStart` string, date-time
    - `deliveryEnd` string, date-time
    - `price` number, double, nullable
  - `market` 'DayAhead' | 'GbHalfHour_DayAhead' | 'N2EX_DayAhead' | 'SemGb_IntradayAuction1' | 'SemGb_IntradayAuction2' | 'SIDC_IntradayAuction1' | 'SIDC_IntradayAuction2' | 'SIDC_IntradayAuction3'
  - `deliveryArea` 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

## 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)