Download OpenAPI specification:
Short-Term Power Scheduling & Nomination
When accessing the API programmatically, please use OAuth2 with the provided CLIENT_ID and CLIENT_SECRET.
Token URL
PRODUCTION: https://auth-token.powerhub.ewe.de/oauth2/token
Example:
POST /token
Host: https://auth-token.powerhub.ewe.de/oauth2/token
Authorization: Basic BASE64(CLIENT_ID:CLIENT_SECRET)
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
When requesting an API resource, use the received ACCESS_TOKEN with the Bearer prefix.
Example:
GET /resource
Host: https://api.powerhub.ewe.de
Authorization: Bearer ACCESS_TOKEN
There are three different types of nominations:
Every nomination object consists of the following keys:
The nomination contains a list of periods, which are defined by the begin and end of the period.
Every period has the length of 15 minutes.
Every nomination needs to contain the full delivery day, therefore consists of 96 periods (92 or 100 periods during DST days).
Depending on the nomination type, each period needs to contain the following values:
Timestamp format is a isoformat (ISO 8601) string in UTC timezone, e.g. "2024-10-01T00:00:00.000Z"
The unit of volume is Megawatt (MW).
Trading Direction:
| contract_id required | string (Contract Id) |
required | Array of objects (Nominations) |
{- "contract_id": "string",
- "nominations": [
- {
- "begin": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "volume": 0
}
]
}null| contract_id required | string (Contract Id) |
required | Array of objects (Nominations) |
{- "contract_id": "string",
- "nominations": [
- {
- "begin": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "volume": 0,
- "price": 0
}
]
}null| contract_id required | string (Contract Id) |
required | Array of objects (Nominations) |
{- "contract_id": "string",
- "nominations": [
- {
- "begin": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "orders": [
- {
- "volume": 0,
- "price": 0
}
]
}
]
}null