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,33 ERE op (50,5% netgemiddeld hernieuwbaar aandeel in 2026 × 0,6588). 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].