my Yuso API

Yuso customers can get access to market data and meterdata using this API interface.
Please download the my Yuso API postman collection to get examples of all the calls.
My Yuso postman collection

Authentication

Use the API key in the URL with the api_key query parameter.

If you don’t have an API key request one with email to support@yuso.be. You will get a unique API key for personal usage. Please don’t share or abuse the provided API key.

Request market prices

GET https://api.my.yuso.io/prices

Query parameters in the request:
api_key
area (currently we have just BE)
market (currently we have just "DA": day ahead prices)
start (ex 2021-01-01)
end (ex 2021-01-02)
Note: you can exclude start and end dates and will automatically get tomorrow’s prices (prices won’t be available until they are officially published usually after 13:00 Brussels time)

Depending on the time interval requested we may return aggregated values per hour, day, week or month. If you want to get hourly data it’s best to request smaller time intervals.

Example

https://api.my.yuso.io/prices?area=BE&market=DA&start=2021-01-01&end=2021-01-02&api_key=<your-api-key>

Response

{
   "aggregation": "HOUR",
   "local_timezome": "Europe/Brussels",
   "price_unit": "EUR/MWh",
   "data": [
       {
           "delivery_start_utc": "2020-12-31 23:00:00",
           "delivery_end_utc": "2021-01-01 00:00:00",
           "delivery_start_local": "2021-01-01 00:00:00",
           "delivery_end_local": "2021-01-01 01:00:00",
           "delivery_date_local": "2021-01-01",
           "price": 50.87
       },
       {
           "delivery_start_utc": "2021-01-01 00:00:00",
           "delivery_end_utc": "2021-01-01 01:00:00",
           "delivery_start_local": "2021-01-01 01:00:00",
           "delivery_end_local": "2021-01-01 02:00:00",
           "delivery_date_local": "2021-01-01",
           "price": 48.19
       },
       {
           "delivery_start_utc": "2021-01-01 01:00:00",
           "delivery_end_utc": "2021-01-01 02:00:00",
           "delivery_start_local": "2021-01-01 02:00:00",
           "delivery_end_local": "2021-01-01 03:00:00",
           "delivery_date_local": "2021-01-01",
           "price": 44.68
       },
	.
	.
	.
       {
           "delivery_start_utc": "2021-01-02 22:00:00",
           "delivery_end_utc": "2021-01-02 23:00:00",
           "delivery_start_local": "2021-01-02 23:00:00",
           "delivery_end_local": "2021-01-03 00:00:00",
           "delivery_date_local": "2021-01-02",
           "price": 48.45
       }
   ]
}

Request SDPs information

GET https://api.my.yuso.io/sdps

Query parameters in the request:
api_key
kbo (can only access own and linked companies)

Example:

https://api.my.yuso.io/sdps?kbo=999999999&api_key=<your-api-key>

Response

{
   "company": {
       "name": "Demo Company",
       "kbo": 999999999,
       "vat": "BE 999.999.999",
       "address_street": "Bliidstraat",
       "address_number": "1",
       "address_zip": 8790,
       "address_city": "Waregem"
   },
   "sdpsData": [
       {
           "ean": "EAN999000000000000201",
           "dgo": "Gaselwest",
           "address_street": "Bliidstraat",
           "address_number": "1",
           "address_zip": 8790,
           "address_city": "Waregem",
           "type": "supply"
       },
       {
           "ean": "EAN999000000000000101",
           "dgo": "Gaselwest",
           "address_street": "Bliidstraat",
           "address_number": "1",
           "address_zip": 8790,
           "address_city": "Waregem",
           "type": "injection"
       }
   ]
}

Request historical data

GET https://api.my.yuso.io/meterdata

Query parameters in the request:
api_key
start (ex 2021-01-01)
end (ex 2021-01-02)
ean (you can add multiple eans separated with a comma - can only access own and linked eans)

Depending on the time interval requested we may return aggregated values per hour, day, week or month. If you want to get quarter-hourly data it’s best to request smaller time intervals:
Hourly data is returned only for time period < 3 months
Quarter-hourly data is returned only for time period < 1 week

Example

https://api.my.yuso.io/meterdata?ean=EAN999000000000000101&start=2021-01-01&end=2021-01-31&api_key=<your-api-key>

Response

{
   "aggregation": "HOUR",
   "local_timezome": "Europe/Brussels",
   "price_unit": "EUR/MWh",
   "volume_unit": "kWh",
   "data": [
       {
           "delivery_start_utc": "2021-02-16 23:00:00",
           "delivery_end_utc": "2021-02-17 00:00:00",
           "delivery_start_local": "2021-02-17 00:00:00",
           "delivery_end_local": "2021-02-17 01:00:00",
           "hour": 0,
           "delivery_date_local": "2021-02-17",
           "ean": "EAN999000000000000101",
           "weightedPrice": 0,
           "price": 0,
           "volume": 0,
           "platformFee": 7
       },
       {
           "delivery_start_utc": "2021-02-17 00:00:00",
           "delivery_end_utc": "2021-02-17 01:00:00",
           "delivery_start_local": "2021-02-17 01:00:00",
           "delivery_end_local": "2021-02-17 02:00:00",
           "hour": 1,
           "delivery_date_local": "2021-02-17",
           "ean": "EAN999000000000000101",
           "weightedPrice": 0,
           "price": 0,
           "volume": 0,
           "platformFee": 7
       },
       {
           "delivery_start_utc": "2021-02-17 01:00:00",
           "delivery_end_utc": "2021-02-17 02:00:00",
           "delivery_start_local": "2021-02-17 02:00:00",
           "delivery_end_local": "2021-02-17 03:00:00",
           "hour": 2,
           "delivery_date_local": "2021-02-17",
           "ean": "EAN999000000000000101",
           "weightedPrice": 0,
           "price": 0,
           "volume": 0,
           "platformFee": 7
       },
       {
           "delivery_start_utc": "2021-02-17 02:00:00",
           "delivery_end_utc": "2021-02-17 03:00:00",
           "delivery_start_local": "2021-02-17 03:00:00",
           "delivery_end_local": "2021-02-17 04:00:00",
           "hour": 3,
           "delivery_date_local": "2021-02-17",
           "ean": "EAN999000000000000101",
           "weightedPrice": 0,
           "price": 0,
           "volume": 0,
           "platformFee": 7
       }
	.
	.
	.
}

Bijgewerkt op: 16/03/2021