Grid Trigger (ENTSO-E)
ENTSO-E negatieve stroomprijs API — day-ahead energieprijs trigger voor het huidige uur. Ideaal als energy price webhook voor ZE-laad- en flexibiliteitsstrategieën.
GET /v1/energy/grid-trigger
Returns the current UTC hour's day-ahead electricity price from the
ENTSO-E Transparency Platform and fires a
trigger: true signal when the price is negative.
Negative electricity prices occur when renewable generation (wind, solar) exceeds grid demand. They are the standard signal for:
- Smart EV charging controllers
- Home and industrial battery storage systems
- Industrial demand-response automation
- Algorithmic energy trading and arbitrage
Request parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
country_code | string | ✗ | NL | ISO alpha-2 country code |
Supported countries
AT, BE, CH, DE, DK, ES, FR, IT, NL, NO, PL, SE
Example request
curl -H "X-API-Key: YOUR_KEY" \
"https://api.omnizoek.nl/v1/energy/grid-trigger?country_code=NL"Example response — negative price (trigger fires)
{
"country_code": "NL",
"current_price_eur_mwh": -12.50,
"negative_price": true,
"trigger": true,
"period_start": "2026-03-06T13:00:00Z",
"period_end": "2026-03-06T14:00:00Z",
"retrieved_at": "2026-03-06T13:15:00Z"
}Example response — positive price (no trigger)
{
"country_code": "NL",
"current_price_eur_mwh": 85.40,
"negative_price": false,
"trigger": false,
"period_start": "2026-03-06T10:00:00Z",
"period_end": "2026-03-06T11:00:00Z",
"retrieved_at": "2026-03-06T10:05:00Z"
}Response fields
| Field | Type | Description |
|---|---|---|
country_code | string | ISO alpha-2 country code |
current_price_eur_mwh | number | Current hour's day-ahead price in EUR/MWh |
negative_price | boolean | true when price is below 0 EUR/MWh |
trigger | boolean | true when a demand-response trigger fires (currently same as negative_price) |
period_start | string | null | Start of the priced interval (ISO 8601 UTC) |
period_end | string | null | End of the priced interval (ISO 8601 UTC) |
retrieved_at | string | UTC timestamp of the ENTSO-E query (ISO 8601) |
Data source
ENTSO-E (European Network of Transmission System Operators for Electricity) publishes day-ahead market clearing prices once per day at approximately 12:00 CET. Prices are quoted in EUR/MWh.
Document type A44 — Day Ahead Prices. Parsed from the XML
Publication_MarketDocument format.
Error responses
| Status | Cause |
|---|---|
400 | Unsupported country code |
503 | ENTSO-E API is unreachable or ENTSO_E_TOKEN is not configured |
Caching
Results are cached per country code for 55 minutes. Since ENTSO-E only publishes new prices once per day, the current-hour price does not change within a publication window — long caching is safe and keeps costs down.
Notes
- Prices can be deeply negative (−200 to −500 EUR/MWh) during peak wind/solar events, especially in Germany, Netherlands, and Denmark.
- The
triggerfield is currently a direct alias fornegative_price. Future versions may add configurable threshold-based triggers (e.g.trigger: truewhenprice < 20 EUR/MWh). - ENTSO-E prices are wholesale market prices, not retail tariffs. Retail customers typically pay a fixed rate regardless of spot prices.