Endpoints - Min Strøm API

Base URL

The Min Strøm API is accessed through the following base URL:

https://api.minstroem.app/thirdParty

Spot prices

Get the future hourly electricity spot prices excl. charges.

GET /prices/{region}


`region`	String	Required	See Regions for possible values

[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 2.04095,
        "color": "yellow"
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 3.6294125,
        "color": "yellow"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`color`	String	Optional	The suggested color to show along with the `price`. This is dynamic based on `region` and whether `charges` are available or not. Possible values are: `green`, `yellow`, `red`.

Full prices (incl. charges)

There are three overall approaches to get electricity prices including all charges.

Coordinate lookup - Using lat/long to look up charges
Address lookup - Using a free text address query to look up charges
Eloverblik (for private consumers) - Using MitID to get household charges

One of the easiest ways to get prices including charges.

GET /prices/location?latitude={latitude}&longitude={longitude}


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The longitude

[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 2.04095,
        "charges": 1.4335,
        "color": "yellow"
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 3.6294125,
        "charges": 2.277875,
        "color": "yellow"
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.
`charges`	Double	Optional	The total amount of charges.
`color`	String	Optional	The suggested color to show along with the `price`. This is dynamic based on `region` and whether `charges` are available or not. Possible values are: `green`, `yellow`, `red`.

Forecast spot prices

Get unconfirmed future hourly electricity prices up to 7 days into the future.

GET /prices/{region}/forecast


`region`	String	Required	See Regions for possible values

[
    {
        "date": "2023-10-12T14:00:00Z",
        "price": 1.04095
    },
    {
        "date": "2023-10-12T15:00:00Z",
        "price": 1.6294125
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price interval start
`price`	Double	Required	The total electricity price for that hour, but only spot price if charges are unavailable.

Charges info

Get full charges information for a specific location and date

GET /prices/charges/location?latitude={latitude}&longitude={longitude}&date={date}


`latitude`	Double	Required	The latitude
`longitude`	Double	Required	The longitude
`date`	Date	Required	ISO8601 timestamp of the price validity

{
    "date": "2024-04-19T23:00:00Z",
    "address": "Feldskovvej 1B, 3. mf., 4180 Sorø",
    "subscriptions": [
        {
            "name": "TSO - System Abonnement",
            "ownerName": "Energinet",
            "price": 0.625
        },
        {
            "name": "Net abo C forbrug time",
            "ownerName": "Cerius A/S",
            "price": 2.19791
        }
    ],
    "tariffs": [
        {
            "name": "Transmissions nettarif",
            "ownerName": "Energinet",
            "price": 0.0925
        },
        {
            "name": "Systemtarif",
            "ownerName": "Energinet",
            "price": 0.06375
        },
        {
            "name": "Elafgift",
            "ownerName": "Energinet",
            "price": 0.95125
        },
        {
            "name": "Nettarif C time",
            "ownerName": "Cerius A/S",
          	"price": 0.14075
        }
    ]
}

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the price validity
`address`	String	Optional	The total electricity price for that hour, but only spot price if charges are unavailable.
`subscriptions`	Array	Required	A list of all applicable subscriptions
`tariffs`	Array	Required	A list of all applicable tariffs

Request count

Get the running request count for your account

GET /currentRequestCount

[
    {
        "date": "2024-05-16T22:00:00Z",
        "requestCount": 1257
    },
    {
        "date": "2024-05-17T22:00:00Z",
        "requestCount": 1104
    }
]

Parameter	Type		Description
`date`	String	Required	ISO8601 timestamp of the day
`requestCount`	Int	Required	The total requests logged for your account on the given `day`

Documentation

​Base URL

​Spot prices

​Full prices (incl. charges)

​Forecast spot prices

​Charges info