Kehittäjäportaali

← Portaali

Energia API

Tuntihintaiset spot-hinnat Suomessa. Tuote: Spot-hinnat · tila: beta

OpenAPI 3.0

openapi: 3.0.3
info:
  title: Tietolahde Energia API
  version: 0.1.0
  description: Nord Pool -spot-hinnat aggregoituna JSON-muotoon
servers:
  - url: https://api.tietolahde.fi/v1
paths:
  /energia/prices:
    get:
      summary: Hae spot-hinnat
      operationId: getEnergiaPrices
      parameters:
        - name: day
          in: query
          schema:
            type: string
            format: date
          description: Päivä (YYYY-MM-DD). Oletus tänään.
      responses:
        '200':
          description: Onnistunut vastaus
          content:
            application/json:
              schema:
                type: object
                properties:
                  updated:
                    type: string
                    format: date-time
                  today:
                    type: array
                    items:
                      type: object
                      properties:
                        time:
                          type: string
                          format: date-time
                        price_eur_mwh:
                          type: number
                        price_eur_kwh:
                          type: number
        '503':
          description: Ingest ei vielä tu tuoretta dataa

Esimerkkipyyntö

GET https://api.tietolahde.fi/v1/energia/prices
Accept: application/json

Esimerkkivastaus

{
  "updated": "2026-08-29T08:00:00+00:00",
  "today": [
    {
      "time": "2026-08-29T08:00:00+00:00",
      "price_eur_mwh": 45.0,
      "price_eur_kwh": 0.045
    }
  ]
}

Huomiot