API en MCP-server
Met de gratis API en MCP-server van enfy reken je energiekosten uit met dezelfde rekenkern als onze vergelijker, ook voor je eigen contract, en vraag je dynamische prijzen, tarieven, prijswijzigingen, prijshistorie en de energiebelasting op. Je hebt geen sleutel nodig en de API werkt zonder cookies; elke uitkomst linkt naar de pagina op onze site met dezelfde cijfers.
Laatst bijgewerkt: 17 november 2026
Wat kun je ermee?
- Berekenen: de goedkoopste stroom- en gascontracten voor een huishouden, met maandbedrag, kosten in het eerste jaar en de opbouw per kostenpost (levering, vaste kosten, energiebelasting, netbeheer, teruglevering en btw).
- Je eigen contract: wat je huidige contract kost met de tarieven van je jaarnota, naast de goedkoopste aanbiedingen voor hetzelfde verbruik, met wat overstappen bespaart. Met de einddatum van je vaste contract ook een indicatie van de opzegvergoeding en vanaf wanneer overstappen loont.
- Dynamisch of vast: het goedkoopste vaste, variabele en dynamische contract naast elkaar, met wat dynamisch kost in een duur, gewoon en goedkoop jaar.
- Netbeheerder: welke netbeheerder bij een postcodegebied hoort en wat de netbeheerkosten per jaar zijn, ook per aansluitwaarde.
- Marktprijzen: de dynamische stroomprijs per kwartier en uur en de gasprijs per gasdag, kaal en all-in.
- Tarieven: laagste, mediaan en gemiddeld tarief per contractvorm, per leverancier wat ook op de leverancierspagina staat, en de gecontroleerde prijswijzigingen met ingangsdatum.
- Historie en belasting: stroom, gas, day-ahead en energiebelasting door de jaren, met bronnen; de energiebelasting per jaar en schijf, met de belastingvermindering.
Alles komt uit gepubliceerde, gecontroleerde data. Hoe we rekenen staat op hoe wij vergelijken. De volledige technische beschrijving staat in openapi.json (OpenAPI 3.1).
Endpoints
Basisadres: https://enfy.nl/api/v1. Alle antwoorden zijn JSON met data en meta; in meta.url staat onze pagina met dezelfde cijfers en in meta.attribution de bronvermelding.
| Endpoint | Wat je krijgt |
|---|---|
| /vergelijk | Top 5 (maximaal 10) aanbiedingen voor een huishouden, vast/variabel op kosten en dynamisch apart, met link naar onze resultaatpagina |
| /eigen-contract | Kosten van je huidige contract met de tarieven van je jaarnota, naast de goedkoopste aanbiedingen, met de besparing en het aantal goedkopere aanbiedingen; met einddatum en leverancier ook de opzegvergoeding |
| /dynamisch-of-vast | Goedkoopste vast 1 jaar, vast van elke looptijd, variabel en dynamisch voor een huishouden, met dynamisch bij de beursprijzen van 2022, 2024, 2020 en de afgelopen 30 dagen, plus ons advies over de contractvorm (contract_advice) |
| /advies | Ons advies over de contractvorm op basis van het prijsniveau nu, met de onderbouwing, de prijs per looptijd en de disclaimer (een vuistregel, geen voorspelling; zoals op welk energiecontract kies je nu?) |
| /netbeheerder | Netbeheerder voor stroom en gas bij postcode (4 cijfers), met de netbeheerkosten per jaar en per maand, dit jaar en volgend jaar, en stroom per aansluitwaarde |
| /leveranciers | Alle actieve leveranciers en of ze in de vergelijking staan |
| /leveranciers/{slug} | Tarieven per contract van één leverancier, zoals op de leverancierspagina |
| /tarieven | Laagste, mediaan en gemiddeld tarief per contractvorm (incl. btw, excl. energiebelasting) |
| /dynamisch/{datum} | Day-ahead-stroomprijs per kwartier en uur, kaal en all-in; datum als JJJJ-MM-DD of vandaag/morgen |
| /gas/{gasdag} | Gasprijs per gasdag (06:00 tot 06:00), kaal en all-in |
| /prijswijzigingen | Gecontroleerde tariefwijzigingen, nieuwste ingangsdatum eerst, met oud en nieuw tarief en het effect per maand; filters leverancier, alleen_komend=1 en aantal |
| /historie/{onderwerp} | stroom, gas, energiebelasting of day-ahead per jaar en de laatste 13 maanden, met bronnen; filter vanaf_jaar |
| /energiebelasting/{jaar} | Energiebelasting per schijf, excl. en incl. btw, met belastingvermindering |
Voorbeeld: vergelijken
Geef het verbruik per jaar van je jaarnota en de netbeheerder, of alleen de 4 cijfers van de postcode. Een huisnummer of adres vragen we nooit.
GET https://enfy.nl/api/v1/vergelijk?kwh_normaal=3500&kwh_dal=1800&m3=1200&postcode=3511&aansluiting=3x35&aantal=3
- Verbruik:
kwh, ofkwh_normaalenkwh_dal;m3ofgeen_gas=1;terugleveringin kWh per jaar bij zonnepanelen. Zonder verbruik rekenen we met het gemiddelde huishouden (2.580 kWh en 790 m³, CBS 2025). - Zonnepanelen zonder bekende teruglevering:
zonnepanelen_wp(alle panelen samen), ofaantal_panelenenwp_per_paneel. Vul bijkwhdan je totale eigen verbruik in. De rekenkern schat per uur, met het weer van de afgelopen 12 maanden, de opwek, wat je direct zelf gebruikt, wat je van het net haalt en wat je teruglevert; de ligging van je dak kennen we niet. De schatting staat inhousehold.solar_estimateen in de aannames, en de link naar de resultaatpagina rekent met dezelfde afname en teruglevering. Een opgegeventerugleveringgaat voor. - Aansluiting:
aansluiting(1x6, 1x10, 3x25, 3x35, 3x50, 3x63, 3x80; standaard 3x25). Een grotere stroomaansluiting heeft hogere netbeheerkosten; de aansluitwaarde staat op je jaarnota of op de hoofdschakelaar in de meterkast. - Regio:
netbeheerder(liander, stedin, enexis, westland-infra, coteq, rendo) voor stroom en gas, metnetbeheerder_gasals gas een andere netbeheerder heeft (bijvoorbeeld stroom Enexis en gas RENDO). Of alleenpostcode(4 cijfers): daaruit leiden we beide af met de open kleinverbruiksgegevens van Liander, Enexis, Stedin, Westland Infra, Coteq Netbeheer en RENDO (2025–2026), per product de netbeheerder met de meeste aansluitingen in dat gebied. Zonder regio: het gemiddelde van alle netbeheerders. - Filters:
contract(vast, variabel, dynamisch),looptijd(1, 2, 3 of 5 jaar),groen=1(alleen groene stroom),groen_nl=1(alleen groene stroom uit Nederland),ingang(JJJJ-MM-DD) enaantal(1 tot en met 10). - Antwoord per aanbieding:
monthly,year1,lines(opbouw per kostenpost),feed_in_assumptions,url(onze resultaatpagina met dezelfde invoer) enprovider_url(onze leverancierspagina). Daarnaastcalculated_at,assumptionsenattribution. - Bedragen: totalen in hele centen (
*_cents), eenheidsprijzen in micro-euro (*_micro), met de tekst ernaast. Inclusief 21% btw, tenzij de naamexcl_vatbevat.
Voorbeeld: je eigen contract doorrekenen
Geef naast het verbruik de tarieven van je jaarnota of contract: de leveringsprijs van stroom (stroomprijs, of stroomprijs_normaal en stroomprijs_dal), van gas (gasprijs) en de vaste leveringskosten per maand (vaste_kosten, of per product vaste_kosten_stroom en vaste_kosten_gas). Bij een dynamisch contract geef je de inkoopvergoeding_stroom en eventueel inkoopvergoeding_gas; bij zonnepanelen kun je terugleververgoeding en terugleverkosten meegeven. Bedragen in euro, met een punt of komma.
GET https://enfy.nl/api/v1/eigen-contract?kwh=2500&m3=1200&postcode=3511&stroomprijs=0,2792&gasprijs=1,1535&vaste_kosten_stroom=9,99&vaste_kosten_gas=8,99
Voorbeeld met de mediaan van de variabele tarieven die nu in de vergelijking staan.
- Prijsbasis: standaard incl. btw en excl. energiebelasting, zoals op de meeste jaarnota's. Met
prijsbasis=excl_btwofprijsbasis=all_in(incl. btw én energiebelasting) rekenen we om met de btw en energiebelasting van dit jaar. Netbeheerkosten en energiebelasting geef je niet op: die zijn bij elke leverancier gelijk. - Antwoord:
own(jouw kosten per maand en in het eerste jaar, met de opbouw per kostenpost om naast je jaarnota te leggen),alternativesendynamicmet per aanbiedingsaving_year1(jouw kosten min die van de aanbieding) enbonus(de welkomstbonus en het deel dat in het eerste jaar meetelt),cheaper(hoeveel aanbiedingen goedkoper zijn),best_saving_year1voor vast en variabel enbest_saving_dynamic_year1met de bandbreedte voor dynamisch. - Einddatum: met
einddatum(enleverancier) van je vaste contract krijg jecontract_end: een indicatie van de opzegvergoeding volgens de Energiewet (je leveringsprijs min die van het referentieproduct van je leverancier, maal je verbruik tot de einddatum), wat overstappen tot die datum bespaart en vanaf wanneer het loont. - Privacy: we bewaren je tarieven niet en het antwoord mag nergens in een cache (
Cache-Control: private, no-store).
Volgorde en betaalde posities
De volgorde in offers en dynamic is alleen op kosten in het eerste jaar, zonder welkomstbonus. Een vergoeding of betaling van een leverancier telt nooit mee. Betaalt een leverancier ooit voor een plek, dan staat die aanbieding apart in paid_positions, met het label "Betaalde positie" en de plek die de aanbieding op kosten heeft. Links gaan altijd naar onze pagina's, nooit rechtstreeks naar een leverancier.
MCP-server koppelen (Claude, ChatGPT en andere assistenten)
Uitleg voor consumenten (koppelen, voorbeeldvragen, wat je wel en niet geeft): energie vergelijken met ChatGPT of Claude.
Dezelfde gegevens zijn beschikbaar als remote MCP-server (streamable HTTP) op https://enfy.nl/mcp, zonder inloggen. Tools: vergelijk_energie, eigen_contract_vergelijken, dynamisch_of_vast, thuisbatterij_berekenen, netbeheerder, stroomprijs_vandaag, gasprijs_vandaag, leverancier_tarieven, prijswijzigingen, prijshistorie, energiebelasting en methode_en_dekking (hoe we vergelijken, hoeveel leveranciers erin staan en hoe actueel de gegevens zijn). Elk resultaat is een korte samenvatting met de links naar onze pagina's en het moment van berekenen, plus de gegevens als structuredContent met een outputSchema en een citation (naam, link, datum en de zin "Bron: enfy (datum)" om te citeren). De rekenende tools noemen in defaults_used welke invoer ze aannamen (zodat de assistent kan doorvragen) en sluiten af met de link naar onze resultaatpagina voor precies die situatie. Met details=true geeft vergelijk_energie ook de opbouw per kostenpost. thuisbatterij_berekenen rekent met dezelfde rekenkern als onze thuisbatterijpagina uit of een thuisbatterij loont: advies, welke soort batterij het meeste oplevert (zonder installatie vergelijken we een stekkerbatterij, een vaste thuisbatterij en losse componenten; zie recommendation), besparing per jaar, terugverdientijd tegen de levensduur, verliezen en de besparing per grootte. Daarnaast is er de prompt jaarnota_vergelijken, die de cijfers van je jaarnota uitvraagt, en de resource methode met hoe we rekenen.
- Claude (claude.ai en de desktop-app): Instellingen → Connectors → Aangepaste connector toevoegen. Vul een naam en de URL
https://enfy.nl/mcpin; authenticatie is niet nodig. Zet de connector daarna aan in een gesprek via het menu met tools. - ChatGPT: Instellingen → Apps en connectors → Geavanceerd → zet de ontwikkelaarsmodus aan en maak een nieuwe connector met de URL
https://enfy.nl/mcpen authenticatie "geen". Kies hem daarna in een gesprek. - Claude Code:
claude mcp add --transport http enfy https://enfy.nl/mcp - Andere clients (Cursor, VS Code en meer): voeg een server toe met type
httpen URLhttps://enfy.nl/mcp.
Gebruik en bronvermelding
De API en de MCP-server zijn gratis. Toon bij elk gebruik de bronvermelding uit meta.attribution ("Bron: enfy, …") met een link naar meta.url; in MCP-antwoorden staat de zin om te citeren in citation.text ("Bron: enfy (datum), …"). Geaggregeerde cijfers mag je hergebruiken onder CC BY 4.0. Een berekening is geen aanbod van een leverancier: wie wil overstappen, controleert de voorwaarden bij de leverancier.
API-sleutel (optioneel)
Je hebt geen sleutel nodig: zonder sleutel werkt alles, met de limieten hieronder. Een sleutel geeft eigen, hogere limieten die per sleutel tellen in plaats van per IP-adres. Sleutels geven we nog niet publiek uit; heb je als organisatie meer verzoeken nodig, neem dan contact op. Een sleutel geeft geen andere of extra gegevens dan zonder sleutel.
- Stuur de sleutel mee in de header
X-Api-Key: enfy_prd_…(of alsAuthorization: Bearer enfy_prd_…). Zet hem nooit in de URL: dat geeft status 400, want URL's komen in logs en de browsergeschiedenis. - Is de sleutel ongeldig, ingetrokken of verlopen, dan krijg je status 401 met
invalid_api_key; we vallen dan niet stil terug op anoniem. Mist de sleutel een recht, dan krijg je 403 metinsufficient_scope. - Rechten (scopes):
publicvoor alle endpoints en de MCP-server,comparevoor een hogere limiet op de berekeningen. Zondercomparegeldt voor berekeningen de gewone limiet, geteld per sleutel. - Een sleutel is voor gebruik op een server. Zet hem niet in een website of app, want daar kan iedereen hem uitlezen.
- Met een sleutel tellen we het gebruik per sleutel. Van de sleutel zelf bewaren we alleen een versleutelde vorm, en ook dan geen IP-adressen.
Limieten en privacy
- Per minuut zonder sleutel: 30 berekeningen (
/vergelijk,/eigen-contracten/dynamisch-of-vast), 120 andere verzoeken en 60 MCP-verzoeken. Elk antwoord bevatX-RateLimit-Limit,X-RateLimit-RemainingenX-RateLimit-Reset; bij te veel verzoeken krijg je status 429 metRetry-After. - Maximaal 10 aanbiedingen per groep; korte querystrings en kleine verzoeken.
- Antwoorden mogen gecachet worden (
Cache-ControlenETag); CORS staat open, dus de API werkt ook vanuit een browser. - De API en de MCP-server werken zonder cookies en we bewaren geen IP-adressen. Voor de limiet tellen we verzoeken onder een versleutelde code die elke dag verandert en na een minuut vervalt. Daarnaast tellen we per dag het aantal verzoeken per endpoint of tool, per soort client en per uitkomst. Van de MCP-server bewaren we per tool-aanroep 90 dagen de tool, de getallen en keuzes die meegestuurd werden (postcode alleen 4 cijfers, geen vrije tekst) en een samenvatting van ons antwoord, om onze antwoorden te controleren; van de REST-API niets (zie privacy).
- Links in MCP-antwoorden hebben
utm_source=mcpen de tool alsutm_campaign; de pagina's tonen dezelfde cijfers.
Versies
Dit is versie 1 (/api/v1). Velden kunnen erbij komen; velden verwijderen of de betekenis veranderen doen we alleen in een nieuwe versie. Fout gezien in een uitkomst? Meld het.