ERE-opbrengst feed

Publiek JSON-endpoint met wat een thuisgeladen kWh netto oplevert • klantgemiddelde, standaardtarief, kWh-gewogen fee, volumegewogen bruto en de laatste verkoop

Joulo noemt op de site één getal voor de opbrengst per kWh, geen bandbreedte. Dit endpoint geeft dat getal en de som erachter: dezelfde bronnen als joulo.nl/ere-verkopen en de homepage. Geen apikey, geen account • gewoon een GET. Alle open datasets staan bij elkaar op joulo.nl/open-data.

Endpoint

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

CORS is open (Access-Control-Allow-Origin: *). Cache-Control: public, max-age=900, s-maxage=900 • het klantgemiddelde komt uit een nachtelijk snapshot en het logboek verandert een paar keer per kwartaal, dus 15 minuten cachen is ruim vers. Het antwoord draagt 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, gerealiseerde ERE-opbrengst (joulo.nl/ere-verkopen), CC BY 4.0

Response

{
  "ok": true,
  "source": "https://joulo.nl/ere-verkopen",
  "docs": "https://developer.joulo.nl/guides/ere-opbrengst-feed",
  "ledger": "https://joulo.nl/api/ere-verkopen",
  "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, gerealiseerde ERE-opbrengst (joulo.nl/ere-verkopen), CC BY 4.0",
  "fields": [
    { "key": "snapshot_date", "provenance": "administratie", "description": "Datum van het nachtelijke snapshot (YYYY-MM-DD)." }
  ],
  "currency": "EUR",
  "unit": "EUR_per_kWh",
  "generated_at": "2026-09-25T10:00:00.000Z",
  "snapshot_date": "2026-09-25",
  "customer_avg_net_eur_per_kwh": 0.129,
  "weighted_fee_pct": 16.05,
  "standard_fee_pct": 20,
  "net_eur_per_kwh_at_standard_fee": 0.123,
  "gross_eur_per_kwh": 0.1533,
  "sale_count": 6,
  "latest_sale": {
    "sale_date": "2026-09-15",
    "sale_month": "2026-09",
    "price_eur_per_ere": 0.4375,
    "gross_eur_per_kwh": 0.146,
    "net_eur_per_kwh_at_standard_fee": 0.116
  }
}

Velden en herkomst

Veld	Herkomst	Betekenis
`snapshot_date`	administratie	Datum van het nachtelijke snapshot waaruit het klantgemiddelde en de gewogen fee komen.
`customer_avg_net_eur_per_kwh`	afgeleid	Wat Joulo-klanten gemiddeld overhouden per kWh: `gross_eur_per_kwh × (1 − weighted_fee_pct / 100)`. Het kopgetal op de site.
`weighted_fee_pct`	afgeleid	De kWh-gewogen effectieve servicekosten van alle geregistreerde particuliere accounts, in procent. Partnertarieven, referral- en loyaliteitskorting wegen mee naar rato van het geladen volume.
`standard_fee_pct`	administratie	Het standaardtarief waarmee een nieuwe klant zonder partner of referral start.
`net_eur_per_kwh_at_standard_fee`	afgeleid	Netto per kWh bij het standaardtarief, dezelfde bruto basis. Zonder dit getal is het klantgemiddelde misleidend voor wie nieuw instapt.
`gross_eur_per_kwh`	afgeleid	Volumegewogen bruto per kWh over alle verkopen in het logboek: `price_eur_per_ere × 0,3327`, gewogen op `volume_mln_ere`.
`sale_count`	administratie	Aantal verkopen in het logboek dat in het gemiddelde meetelt.
`latest_sale`	confirmatie	De nieuwste verkoop uit het logboek, met netto bij het standaardtarief. Een momentopname; het gemiddelde erboven is wat een klant over het jaar krijgt.

Het aantal accounts achter het klantgemiddelde staat bewust niet in de feed. "kWh-gewogen" zegt hoe het gemiddelde tot stand komt; het aantal klanten publiceert Joulo alleen naar boven afgerond op 500, in de platformcijfers.

Zo rekent het

Elke verkoop in het verkooplogboek heeft een prijs per ERE. Eén kWh thuislading is 0,3327 ERE (50,5% hernieuwbaar × 0,6588), dus bruto per kWh = prijs per ERE × 0,3327.
Het volumegewogen gemiddelde van die bruto's over alle verkopen is gross_eur_per_kwh. Eén verkoop is een momentopname; het gemiddelde is wat een klant over het jaar werkelijk krijgt.
Netto = bruto × (1 − fee). Bij het standaardtarief geeft dat net_eur_per_kwh_at_standard_fee; bij de kWh-gewogen fee van alle klanten customer_avg_net_eur_per_kwh.

De volledige uitleg met bronnen staat op joulo.nl/zo-rekenen-wij.

Voorbeelden

curl

curl https://joulo.nl/api/ere-opbrengst | jq '.customer_avg_net_eur_per_kwh'

JavaScript (fetch)

const res = await fetch("https://joulo.nl/api/ere-opbrengst");
const d = await res.json();
console.log(`Klanten krijgen gemiddeld ${(d.customer_avg_net_eur_per_kwh * 100).toFixed(1)} cent per kWh (bij ${d.standard_fee_pct}%: ${(d.net_eur_per_kwh_at_standard_fee * 100).toFixed(1)} cent)`);

Foutgevallen

De endpoint geeft altijd HTTP 200 terug. Bij een upstream-fout staat ok: false in het lichaam; check dus op ok, niet op de statuscode.

Bronvermelding

De feed is vrij te gebruiken onder CC BY 4.0 met de citeerregel hierboven. Vragen over de som? Mail [email protected].

On this page