JouloDocs

ERE-marktprijs feed

Publiek JSON-endpoint met de wekelijkse LRE-E spotmarktprijs per ERE-credit (€/ERE)

Joulo publiceert de wekelijkse LRE-E spotmarktprijs voor ERE-credits als open JSON-feed. Geen apikey, geen account — gewoon een GET. Hetzelfde getal dat op joulo.nl/status staat.

Endpoint

GET https://joulo.nl/api/ere-price

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.

Query parameters

ParameterDefaultBereikBeschrijving
weeks_back121 • 104Aantal weken historie in history.

Response

{
  "ok": true,
  "currency": "EUR",
  "unit": "EUR_per_ERU",
  "current": {
    "year": 2026,
    "week_number": 19,
    "bid_eur": 0.49,
    "offer_eur": 0.51,
    "mid_eur": 0.5,
    "source": "LRE-E spotmarkt",
    "note": "Initiële inboeking",
    "updated_at": "2026-05-12T08:00:00Z"
  },
  "history": [
    { "year": 2026, "week_number": 17, "bid_eur": 0.47, "offer_eur": 0.49, "mid_eur": 0.48, "updated_at": "..." },
    { "year": 2026, "week_number": 18, "bid_eur": 0.48, "offer_eur": 0.50, "mid_eur": 0.49, "updated_at": "..." },
    { "year": 2026, "week_number": 19, "bid_eur": 0.49, "offer_eur": 0.51, "mid_eur": 0.50, "updated_at": "..." }
  ],
  "fetched_at": "2026-05-18T10:00:00Z"
}

history is oplopend gesorteerd (oudste week eerst, huidige week laatst), zodat je hem direct in een grafiek kunt plotten.

De prijs is per ERE-credit (€/ERE), niet per kWh. Eén kWh thuislading levert ongeveer 0,2 ERE op (afhankelijk van het netgemiddeld hernieuwbaar aandeel). De waarde die jij ziet in je dashboard is de doorberekende netto vergoeding per kWh na de Joulo-fee.

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")

Of in een cel waar je de huidige mid-prijs wil:

=VALUE(REGEXEXTRACT(JOIN("", IMPORTDATA("https://joulo.nl/api/ere-price")), """mid_eur"":([0-9.]+)"))

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. Skipping a week is veilig — de feed blijft de meest recent ingeboekte week tonen tot de volgende update.

Vragen of onverwacht gedrag? Mail [email protected].