Spot Prices

Spot prices can be retrieved by making a call to /smart/v1/prices/actual/{priceArea}, where priceArea is one of the five price areas in Norway (NO1-5). One of the features of the API allows you to make requests to /smart/v1/prices/actual/{priceArea}/advice to get an opinionated advice on the best interval to charge using supplied parameters.

Querying Spot Prices

Getting individual spot prices for a given price area is covered in GettingStarted.

Advice

The API can deliver the optimal charging interval given certain parameters. The result from this type of query serves as an opinionated advice on when to start charging. As of right now, price is the only variable taken into account, but additional variables will be taken into account in future iterations.

To make an API call simply run the following code:

curl -X 'POST' \
  'https://api.voluespark.com/smart/v1/prices/actual/NO1/advice' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "priceUnitParameters": {
    "currency": "NOK",
    "energyUnit": "kWh",
    "vatRate": 1.25
  },
  "chargingSessionParameters": {
    "power": 3.8,
    "duration": 8
  },
  "startFrom": "2023-03-09T13:12:07.043Z"
}'

The result of this query will be a list of timeslots with total cost, as well as whether to avoid or not, for the next 24-hour period.

{
    "advice": [
        {
            "from": "2023-03-09T13:13:15.593Z",
            "to": "2023-03-09T13:13:15.593Z",
            "type": "Unknown",
            "cost": 0,
            "averagePrice": 0
        }
    ],
    "spotPrices": [
        {
            "time": "2023-03-09T13:13:15.593Z",
            "price": 0
        }
    ],
    "priceArea": "NO1",
    "currency": "EUR",
    "energyUnit": "kWh",
    "pricesIncludingVAT": true,
    "vatRate": 0
}

Examples

Below are examples on how the data might be visualized. These can also be viewed in Storybook.

Spot Prices

Nå

Bør unngås

Spot Price Advice

24 kr

17:52 - 21:52

inkl. MVA