ERE-marktprijs feed

Publiek JSON- en CSV-endpoint met de wekelijkse LRE-E spotmarktprijs per ERE-credit (€/ERE), open data onder CC BY 4.0

Joulo publiceert de wekelijkse LRE-E spotmarktprijs voor ERE-credits als open feed. Geen apikey, geen account • gewoon een GET. Hetzelfde getal dat op joulo.nl/status staat. Alle open datasets staan bij elkaar op joulo.nl/open-data.

Endpoints

GET https://joulo.nl/api/ere-price          # JSON: huidige week + historie
GET https://joulo.nl/api/ere-price.csv      # CSV: één rij per week

CORS is open (Access-Control-Allow-Origin: *). Cache-Control: public, max-age=300, s-maxage=300 • de cijfers veranderen wekelijks, dus 5 minuten cachen is veilig. Beide antwoorden dragen een Link: <https://creativecommons.org/licenses/by/4.0/>; rel="license"-header en een X-Attribution-header met de citeerregel.

Licentie en citeerregel

De dataset staat onder Creative Commons Attribution 4.0 (CC BY 4.0). Je mag de data kopiëren, bewerken en verspreiden, ook commercieel en ook in een AI-antwoord, zolang je de bron noemt:

Bron: Joulo, ERE-marktprijs per week (joulo.nl/status), CC BY 4.0

Query parameters

Parameter	Default	Bereik	Beschrijving
`weeks_back`	`12` (JSON), `104` (CSV)	1 • 104	Aantal weken historie in `history`, of het aantal rijen in de CSV.

Response (JSON)

{
  "ok": true,
  "source": "https://joulo.nl/status",
  "docs": "https://developer.joulo.nl/guides/ere-price-feed",
  "csv": "https://joulo.nl/api/ere-price.csv",
  "license": {
    "id": "CC-BY-4.0",
    "name": "Creative Commons Attribution 4.0 International",
    "url": "https://creativecommons.org/licenses/by/4.0/"
  },
  "attribution": "Joulo (joulo.nl)",
  "citation": "Bron: Joulo, ERE-marktprijs per week (joulo.nl/status), CC BY 4.0",
  "fields": [
    { "key": "year", "provenance": "administratie", "description": "ISO-jaar van de week." }
  ],
  "currency": "EUR",
  "unit": "EUR_per_ERU",
  "current": {
    "year": 2026,
    "week_number": 38,
    "bid_eur": 0.42,
    "offer_eur": 0.435,
    "mid_eur": 0.4275,
    "source": "LRE-E spotmarkt",
    "note": null,
    "updated_at": "2026-09-14T07:20:29Z"
  },
  "history": [
    { "year": 2026, "week_number": 36, "bid_eur": 0.435, "offer_eur": 0.45, "mid_eur": 0.4425, "updated_at": "..." },
    { "year": 2026, "week_number": 38, "bid_eur": 0.42, "offer_eur": 0.435, "mid_eur": 0.4275, "updated_at": "..." }
  ],
  "fetched_at": "2026-09-25T10:00:00Z"
}

history is oplopend gesorteerd (oudste week eerst, huidige week laatst), zodat je hem direct in een grafiek kunt plotten. De sleutels ok, currency, unit, current, history en fetched_at bestaan sinds de eerste versie van de feed en blijven staan; de envelope eromheen (license, citation, fields, csv) kwam er in september 2026 bij.

Velden en herkomst

Elke waarde heeft één van drie herkomsten: bron (zoals de broker de prijs meldde), afgeleid (door ons berekend) of administratie (uit onze eigen inboeking).

Veld	Herkomst	Betekenis
`year`	administratie	ISO-jaar van de week.
`week_number`	administratie	ISO-weeknummer (1 t/m 53).
`bid_eur`	bron	Biedprijs per ERE in euro op de LRE-E spotmarkt.
`mid_eur`	afgeleid	Midden tussen bied- en laatprijs: `(bid_eur + offer_eur) / 2`.
`offer_eur`	bron	Laatprijs per ERE in euro op de LRE-E spotmarkt.
`updated_at`	administratie	Moment waarop Joulo de week heeft ingeboekt (ISO 8601).

CSV

Eén rij per week, kolommen in de volgorde van de tabel hierboven. De huidige week staat erbij, ook als hij nog niet in history zit. Komma als scheidingsteken, punt als decimaalteken, UTF-8, regeleinde \r\n.

curl -s https://joulo.nl/api/ere-price.csv | head -3

year,week_number,bid_eur,mid_eur,offer_eur,updated_at
2026,36,0.435,0.4425,0.45,2026-09-03T06:32:21.299394+00:00
2026,38,0.42,0.4275,0.435,2026-09-14T07:20:29.173084+00:00

De prijs is per ERE-credit (€/ERE), niet per kWh. Eén kWh thuislading levert ongeveer 0,33 ERE op (50,5% netgemiddeld hernieuwbaar aandeel in 2026 × 0,6588). Wat een kWh netto oplevert staat in de ERE-opbrengst feed.

Voorbeelden

curl

curl https://joulo.nl/api/ere-price | jq '.current.mid_eur'

JavaScript (fetch)

const res = await fetch("https://joulo.nl/api/ere-price?weeks_back=26");
const { current, history } = await res.json();
console.log(`Wk ${current.week_number}/${current.year}: €${current.mid_eur}/ERE`);

Google Sheets

=IMPORTDATA("https://joulo.nl/api/ere-price.csv")

Home Assistant

sensor:
  - platform: rest
    resource: https://joulo.nl/api/ere-price
    name: "ERE mid-prijs"
    value_template: "{{ value_json.current.mid_eur }}"
    unit_of_measurement: "€/ERE"
    scan_interval: 3600

Foutgevallen

De endpoint geeft altijd HTTP 200 terug. Bij een upstream-fout staat ok: false in het lichaam:

{
  "ok": false,
  "error": "upstream_error",
  "message": "…"
}

Cliënten moeten op ok checken, niet op statuscode.

Bron en frequentie

De wekelijkse bid/offer wordt door Joulo handmatig ingeboekt op basis van de LRE-E spotmarkt. Een week overslaan is veilig • de feed blijft de meest recent ingeboekte week tonen tot de volgende update.

Vragen of onverwacht gedrag? Mail support@joulo.nl.

On this page