Nordpool Intra Day Spot
Dusseldorf, Germany February 2016
Nord Pool Market Adapter Requirement Specification Page 1 of 13
Table of Content 1
BUSINESS REQUIREMENTS
5
2
SCOPE, OVERVIEW AND EXECUTION
5
3
NORDPOOL SPOT
6
3.1 INTRADAY MARKET 3.1.1 Introduction
6 6
The majority of the volume handled by Nord Pool is traded on the day-ahead market. For the most part, the balance between supply and demand is secured here. However, incidents may take place between the closing of the day-ahead market at noon CET and delivery the next day. A nuclear power plant may stop operating in Sweden, or strong winds may cause higher power generation than planned at wind turbine plants in Germany. At the intraday market, buyers and sellers can trade volumes close to real time to bring the market back in balance. 6 3.1.2 Trading close to real time 6 3.1.3 Increasingly Importance 6 3.2
Day-ahead MARKET
6
Today there are around 360 buyers and sellers (called members) on the day-ahead market. Most of them trade every day, placing a total of around 2000 orders for power contracts on a daily basis. 3.2.1 Driven by Planning 3.2.2 Setting the Price and closing the deal 3.2.3 The cost of transmission constraints
6 6 6 7
3.3 Integrated Europe 3.3.1 Introduction
7 7
3.4
Transmission System Operators
7
4
NORDPOOL API
8
4.1 Authentication 4.1.1 Basic Analysis 4.1.2 Technical Details
8 8 8
4.2 Request Signature 4.2.1 Basic Analysis 4.2.2 Technical Details
9 9 9
4.3 INTRADAY API 4.3.1 Basic Analysis 4.3.2 Technical Details
9 9 9
5
TEST ENVIRONMENT
10
6
PRODUCTION ACCEPTANCE
10
Nord Pool Market Adapter Requirement Specification Page 2 of 13
7
CONTACTS
11
8
QUESTIONS
11
9
ACRONYMS AND GLOSSARY
11
10
SOME USEFUL LINKS AND CREDENTIALS
11
11
REFERENCES
12
Nord Pool Market Adapter Requirement Specification Page 3 of 13
Revision History S No
Version Revision Date
Revised By
Revision Details
Nord Pool Market Adapter Requirement Specification Page 4 of 13
1 Business Requirements [Draft] Auto deal capture via Fuse to Endur System [Draft] Design NordPool Spot Market Adapter (NPS MA) – Fail Safe Market Adapter [Draft] Design NordPool Spot Interface which converts NPS MA provided trade to Endur understandable format.
2 Scope, Overview and Execution The scope of the Market Adapter includes the following things. [Draft]
Nord Pool Market Adapter Requirement Specification Page 5 of 13
3 NordPool Spot 3.1
INTRADAY MARKET Nord Pool offers an intraday market covering the Nordic, Baltic, UK and German markets. The intraday market supplements the day-ahead market and helps secure the necessary balance between supply and demand in the power market for Northern Europe.
3.1.1 Introduction The majority of the volume handled by Nord Pool is traded on the day-ahead market. For the most part, the balance between supply and demand is secured here. However, incidents may take place between the closing of the day-ahead market at noon CET and delivery the next day. A nuclear power plant may stop operating in Sweden, or strong winds may cause higher power generation than planned at wind turbine plants in Germany. At the intraday market, buyers and sellers can trade volumes close to real time to bring the market back in balance.
3.1.2 Trading close to real time At 14:00 CET, capacities available for Nord Pools intraday trading are published. This is a continuous market, and trading takes place every day around the clock until one hour before delivery. Prices are set based on a first-come, first-served principle, where best prices come first – highest buy price and lowest sell price.
3.1.3 Increasingly Importance The intraday market is becoming increasingly important as more wind power enters the grid. Wind power is unpredictable by nature, and imbalances between day-ahead contracts and produced volume often need to be offset. The market plays a key role in the development of intraday power trading in Europe. Future prospects indicate exponential growth, reaching 1.900 GW installed wind Capacity worldwide in 2020 (Source: World Wind Energy Association). This type of market can be a key enabler to increase the share of renewable energy in the energy mix.
3.2
Day-ahead MARKET The day-ahead market is the main arena for trading power. Here, contracts are made between seller and buyer for the delivery of power the following day, the price is set and the trade is agreed. Today there are around 360 buyers and sellers (called members) on the day-ahead market. Most of them trade every day, placing a total of around 2000 orders for power contracts on a daily basis.
3.2.1 Driven by Planning Daily trading is driven by the members’ planning. A buyer, typically a utility, needs to assess how much energy (‘volume’) it will need to meet demand the following day, and how much it is willing to pay for this volume, hour by hour. The seller, for example the owner of a hydroelectric power plant, needs to decide how much he can deliver and at what price, hour by hour. These needs are reflected through orders entered by buyers and sellers into the Nord Pool day-ahead trading system.
3.2.2 Setting the Price and closing the deal 12:00 CET is the deadline for submitting bids for power which will be delivered the following day. The trading system feeds the information into a specialist computer system which calculates the price, based on an advanced algorithm. Put simply, the price is set where the curves for sell price and buy price meet. Nord Pool Market Adapter Requirement Specification Page 6 of 13
Hourly prices are typically announced to the market at 12:42 CET or later. Once the market prices have been calculated, trades are settled. From 00:00 CET the next day, power contracts are physically delivered (meaning that the power is provided to the buyer) hour for hour according to the contracts agreed.
3.2.3 The cost of transmission constraints While supply and demand are the key factors determining the hourly market prices, transmission Capacity also plays a role. Bottlenecks can occur where power connections are linked to each other, if large volumes need to be transmitted to meet demand. To relieve this congestion, different area prices are introduced. In other words, when Transmission capacity gets constrained, the price is raised to reduce demand in the areas affected.
3.3
Integrated Europe The European Commission has a stated goal of harmonizing the European power markets. The aim is to create a pan-European market with closer connecting of power markets to improve the efficient use of energy across national borders, the European Target Model for electricity market integration.
3.3.1 Introduction As Europe’s leading power market, active in nine countries, and, with the Nordics presenting the world with its first deregulated power market, Nord Pool has carved ourselves a position at the very heart of delivering the European target model for 2014. We are fully focused on achieving what is best for the future of the European power market and our members. Under the Target Model, the EU has set up common rules to bring-on efficient use of cross-border Capacity and harmonization of European wholesale power market arrangements. The main features of the model are day-ahead Market coupling and continuous intraday trading to allow cross-border trading of electricity closer to real time; electricity balancing between TSOs; and long-term transmission rights to access capacity on interconnectors. That has involved working diligently for the delivery of the Price Coupling of Regions (PCR) and the NorthWestern European Price Coupling (NWE) launched in February 2014. Since then two extensions of the PCRcoupled area have taken place. Spain and Portugal joined in May 2014, while Italy coupled with France, Austria and Slovenia in February 2015. This full area is called Multi-Regional Coupling and now covers 19 countries, standing for about 85% of European power consumption. Nord Pool is as well fully involved in the Cross-Border Intraday Market project (XBID).
3.4
Transmission System Operators A system operator is responsible for an area to be electrically stable, and for the security of supply in his area. A system operator has to be a non-commercial organization, neutral and independent with regard to the market members. In the Nordic countries, the system operators have the responsibility for both the security of supply and the high-voltage grid (the transmission grid). The Nordic transmission system operators are Statnett SF (Norway), Svenska Kraftnät (Sweden), Fingrid (Finland) and Energinet.dk (Denmark). The Estonian TSO is Elering and the Lithuanian TSO is Litgrid. In Latvia it is the independent transmission system operator AST. In the UK National Grid is the transmission system operator. Nord Pool Market Adapter Requirement Specification Page 7 of 13
4 Nordpool API 4.1
Authentication
In NordPool authentication is centralized same API credentials can be used to access different APIs. NordPool
4.1.1 Basic Analysis
4.1.1.1 Three Steps are required for get API Working 1. Request for access Token 2. Get Token from API 3. Request for required resources along with API.
4.1.1.2 Access Token Characteristics 1. Client Each API exposed by Nord Pool can be only consumed by well-defined API clients. API clients are defined by Nord Pool Spot. API client definition is publicly distributed. 2. API User In order to access API, each API consumer is given from Nord Pool API username and password. Password is a secret, thus should be kept in well protected safe place. API consumers are fully responsible for protecting the password. 3. Scope Scope of the token determines with which APIs in NordPool it can be used. 4. Expiration Expiration indicates how long token is valid. Once token expires API user need to request for a new token from Nord Pool authentication service.
4.1.2 Technical Details
4.1.2.1 Token Request Token can be requested from publicly exposed Nord Pool authentication service. HTTPS protocol is used for requesting and receiving the token. Below is the example of the token request parameters: HTTP method: POST Sl. No URL 1. https://apists.nordpoolspotdev.com/connect/token 2. https://apists.nordpoolspotqa.com/connect/token 3. https://apists.nordpoolspot.com/connect/token Headers and Body: Sl. No
Message
1. 2. 3.
Header Header Body
Environment Dev Environment QA / Member Test Environment Production
Authorization: Basic Y2xpZW50X3JlbWl0X2FwaTpjbGllbnRfcmVtaXRfYXBp Content-Type: application/x-www-form-urlencoded grant_type=password&username=test_user&password=test_password&scope=api_test
Nord Pool Market Adapter Requirement Specification Page 8 of 13
NOTE: Authorization is encoded string client:client with base64. For example if client = client_remit_api, than string to be encoded will be : client_remit_api:client_remit_api and base64 of this string will be Y2xpZW50X3JlbWl0X2FwaTpjbGllbnRfcmVtaXRfYXBp
4.1.2.2 Token Response If API username, password and scope are correct. Below response is received and response contains access token along with expiration date: Sl. No
Message
1. 2. 3.
Status Header Body
200 OK Content-Type: application/json; charset=utf-8 {"access_token":"eyJ0eXAiOiJKV1QiLCJhFjwjNw","expires_in":3600,"token_type":"Bearer"}
4.1.2.3 Resource Request Example of resource request against API in case of HTTPS protocol: Sl. No
Message
1. 2. 3. 4. 5.
HTTP Method URL Header Other Headers Body
POST / GET / PUT/ DELETE https://apitest.nordpoolspot.com/resourceid/test Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhFjwjNw Other headers specific to the API request specific to the API request
Note: In Authorization header access_token is used which was received in step 2. 4.2
Request Signature
4.2.1 Basic Analysis In order to strengthen security for placing/updating/removing fragile resources (e.g. orders), request signature of the requesting party is required. Signature is a Hash-based Message Authentication Code (HMAC) constructed from the request and computed by using the SHA256 algorithm, and then encoded by using Base64 encoding. More details regarding implementation to be provided later. NOTE: For the testing period signing has been turned off.
4.2.2 Technical Details 4.3
INTRADAY API
4.3.1 Basic Analysis 4.3.2 Technical Details
Nord Pool Market Adapter Requirement Specification Page 9 of 13
5 Test Environment [Draft] We are hosting a test environment that serves as a sandbox for all API developers. You can freely use it by logging in with your given username and password. Please note that accessing the production system is not allowed until the solution you've developed meets our production acceptance criteria. Getting access to the test environment Getting access to our test environment is easy. All you need is to contact our trading desk to ask for an account and get your personal credentials. Getting access to the test environment via GUI: To be able to placing orders manually and monitor API calls following link can be used: http://apidev.intraday.nordpoolspot.com/webclient/#/login Contact to Support to get users for this environment.
6 Production Acceptance [Draft] Read-only use case Intraday api_* users will be set up with read-only restrictions Individual test sessions will be set up for each company in order to test the developed solution Prior to the test session members are required to provide a list containing the Requests that are supposed to be sent via the API. Read & write use case Intraday api_* users will be set up with read and write user Individual test sessions will be set up for each company in order to test the developed Prior to the test session members are required to provide a list containing the Requests that are envisaged to be sent via the API. Prior to the test session a test script containing a pre-defined set of tasks (e.g. submitting and editing orders of different types) for the relevant control areas will be provided by NPS During the test session the member is expected to follow the steps described in the test script Upon successful completion of the test cases Nord Pool will grant access to the production system, provided that the necessary membership agreements are in place. Please get in contact with us at
[email protected] if you wish to set up a test date. Details for connecting to Intraday production platform: The SSO token must be fetched from a different SSO server than in the test environment. in production, the token must be fetched from: https://sso.nordpoolspot.com/connect/token For connecting proprietary system to Intraday API message queue, please use following address: elbasamqp.nordpoolspot.com:443. The connection is secured with SSL/TLS encryption and listens at TCP port 443 If you want to be able to use the Intraday web client, please verify that you can open a web socket connection to following endpoint: https://elbassockjs.nordpoolspot.com:443. The connection is secured with SSL/TLS encryption and listens at TCP port 443.
Nord Pool Market Adapter Requirement Specification Page 10 of 13
7 Contacts SL. No. 1. 2. 3. 4.
Name Intraday API Wenzel, Markus Stöhr, Sebastian Sebjornsen, Atle
Desc Group Mailbox Trader One Point Contact for Dispatch Nordpool API Team
Email
[email protected] [email protected] [email protected] [email protected]
8 Questions Sl. No 1. Ans. 2. Ans. 3. Ans.
Q&A Why this Market Adapter is required? What is difference b/w Intraday Market and Day-Ahead Market? What kinds of Trades are available? As Per NordPoolSpot Hourly, Daily, Weekly, Yealy.
9 Acronyms and Glossary Sl. No 1 2
Phrase NPS MA Capacities
3 4
Transmission Capacity Market Coupling
Notes NordPool Spot Market Adapter The maximum amount of energy that can flow from one bidding area to another. The transmission system operators determine the trading capacities for each hour of the day. Capacities can thus vary from hour to hour. North-Western European Price Coupling A process where power exchanges cooperate on utilizing the available trading capacity between two or more regions during every hour of operation to secure that the energy flows from the low-price towards the high-price area
10 Some Useful Links and Credentials SL. No 1. 2.
URL http://api-dev.intraday.nordpoolspot.com/elbas4/docs/ https://npsdevelopers.atlassian.net/wiki/
Username
Password
idapi API_UNIPER
idapi 2015Uniper$
Nordpool Credentials SSO:Uo88YmMpKUp!PfQB83bc TEST_API_UNIPER password: ksDZv17R NOTE: These passwords are meant for development. Updated password could be found in Middleware Mailbox notes. Nord Pool Market Adapter Requirement Specification Page 11 of 13
11 References 1. http://www.nordpoolspot.com/TAS/Day-ahead-market-Elspot/ 2. https://npsdevelopers.atlassian.net/wiki Hi, please use it in the following way: curl -H "Authorization: Basic Y2xpZW50X2ludHJhZGF5X2FwaToxeEI5SWsxeHNFdTJuYndWYTFCUg==" -H "ContentType:application/x-www-form-urlencoded" --data "grant_type=password&username=api_juniper&password=
&scope=intraday_api" -k https://sso.nordpoolspotdev.com/connect/token
• The Authorization value is static, do not change that, and please replace with your password. Best regards, Laszlo
Dear Pratiyush, Thank you for your interest in getting access to Nord Pool Intraday API test environment. Your credentials have been created and can be found below. Once you are done testing in the API dev environment and you feel that your code works as expected please let us know and we will provide you access to the pre-production environment. Generic info Server
URL
Identity (SSO) server
https://sso.nordpoolspotdev.com/connect/token
Intraday AMQP server address #1 (SSL off)
api-dev.intraday.nordpoolspot.com:5672
Intraday AMQP server address #2 (SSL on)
api-dev.intraday.nordpoolspot.com:5671
Intraday server virtual host
elbas4_vhost
User credentials Username
Purpose
Username
Password
SSO / RabbitMQ username Intraday user (API)
Get token from SSO and connect to the
api_uniper
to be sent via text
RabbitMQ broker Log in to the intraday system (API)
TEST_API_UNIPER
message* to be sent via text
Intraday users
Log in to the intraday clients (Java or
TEST_UNIPER_1
message* no password
Web)
TEST_UNIPER_2
required
* Passwords can take up to 1 hour to arrive after receiving this email Portfolio information
Nord Pool Market Adapter Requirement Specification Page 12 of 13
Portfolio No
Portfolio name
Intraday portfolio #1
TEST_UNIPER_AMP
Intraday portfolio #2
TEST_UNIPER_TTG
Intraday portfolio #3
TEST_UNIPER_DK1
Intraday portfolio #4
TEST_UNIPER_DK2
Intraday portfolio #5
TEST_UNIPER_SE3
Intraday portfolio #6
TEST_UNIPER_SE4
URL to API dev Java & web client http://elbas.nordpoolgroupqa.com/ Best regards, Atle Reference Int Portfolio Point Of Receipt Start Date End Date Start Time End Time Quantity Buy / Sell Tran Status Trade Date Int Contact Broker Id source_trade_id deal_source Trade Time Ext Bunit Price
EDRS.EPEX.101698309010YDE-EON------1.B MISC_UNASSIGNED HUB TENNETDE 26/01/2016 26/01/2016 07:00:00 08:00:00 7.5 Buy Pending 26/01/2016 None EDRS.EPEX.101698309010YDE-EON------1.B EPEX 2016-01-26T04:39:03.980Z ECC - BU 38.4
Nord Pool Market Adapter Requirement Specification Page 13 of 13