Reference · built on requestCommons signalEnergy & grid

Fingrid Open Data

Finland's transmission system operator publishes power system time series through a REST API with a free registered key.

About

Fingrid Oyj runs Finland's nationwide high-voltage grid and publishes measured and forecast data about the power system and electricity market on data.fingrid.fi. The catalogue lists 249 datasets, almost all of them time series, and many update in near real time. Browsing and downloading in the portal need no account; the REST API needs a free key issued through the developer portal.

An operator on Fibric reads the datasets you choose by datasetId, such as electricity production, consumption, or system frequency, and turns them into proposals: a reserve hold when frequency drifts, or an export cap when the grid is long. You approve each one.

This is a reference listing. It documents what Fibric would read from Fingrid Open Data and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • The public dataset catalogue through GET /api/datasets, paginated, with a search parameter that sorts by relevance
  • Rows for one dataset through GET /api/datasets/{datasetId}/data, and the newest row through /data/latest
  • Several datasets in one call through GET /api/data?datasets=, and rows modified in a period through /api/data/updates
  • Electricity production in Finland (dataset 74) in MWh/h, at 15-minute resolution since 13 June 2023 and hourly before
  • Real-time series for electricity consumption, system frequency, wind power, and transmission between Finland and Estonia
  • Kinetic energy of the Nordic power system, reserve and balancing market series, and emission factors
  • Service notices through GET /api/notifications/active and status through /api/health

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Hold battery reserve when frequency drifts

    Poll the real-time frequency and kinetic energy series within the key's rate limit and propose a reserve hold or discharge block for the site battery. You approve; the readings are attached.

    With Battery Dispatch, Storm Reserve

  • Cap solar export when Finnish production runs high

    Read national production and the Finland-Estonia transmission series alongside the inverter output, and propose an active-power cap for the hours the grid is long.

    With Export Limit

  • Shift load using Fingrid's emission factors

    Read the emission factor datasets and propose moving flexible loads and charging into the lowest-emission hours, with the figure kept for reporting.

    With Carbon Window, Peak Demand

Requirements

  • A registered account on data.fingrid.fi and one Open Data starter subscription in the developer portal
  • The datasetId for each series, taken from the dataset page
  • Timestamp handling in UTC, since Finnish local time runs two or three hours ahead
  • Attribution under CC BY 4.0 for datasets produced by Fingrid
Authentication
A free API key sent in the x-api-key header. You register with an email address, open the developer portal, and subscribe to the Open Data starter product to get the key.

Limits

  • Throttling per key: 10,000 requests in a 24-hour period and one request every two seconds
  • Repeatedly exceeding the query limits may lead to restricted access or account closure
  • Datasets from other organisations, such as the nine from Datahub, may carry different licence terms
  • Fingrid does not warrant the completeness or accuracy of the data and asks that clients handle API downtime

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request Fingrid Open Data ↗

Questions and answers

How do you get a Fingrid API key?
Sign up on data.fingrid.fi, open the developer portal from the control panel, go to Products, and subscribe to Open Data starter. The key appears on your profile page and must be sent in the x-api-key request header, not in the URL. Registration needs only a valid email address.
What are the rate limits?
Per API key: 10,000 requests in any 24-hour period and at most one request every two seconds. Fingrid says these limits keep the API available during peak use, and that you can contact the administrator if you need more.
Under what licence is the data published?
Datasets produced by Fingrid are licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). Where a dataset comes from another organisation, its own licence and terms are described on that dataset's page. Fingrid's general legal terms also apply to the service.
Ask about Fingrid Open Data

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.