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
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.

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
Response
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
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
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
Dankuwel!