ikrovimo-kaina.lt

Atviras įkrovimo kainų API

JSON, be registracijos ir be API rakto — stotelės, kainos, istorija ir elektros kaina biržoje

ikrovimo-kaina.lt duomenis galite naudoti savo programose, tyrimuose, žurnalistikoje ar automobilių parko valdymo sistemose. API yra nemokamas, be registracijos ir be rakto, grąžina JSON ir leidžia užklausas iš naršyklės (CORS *). Tai tie patys duomenys, kuriuos rodome svetainėje: kainos su PVM, atnaujinamos kas 6 valandas, o laisvų įkrovimo taškų būsena — kas 5 minutes.

Bazinis adresas: https://ikrovimo-kaina.lt/api/v1

Licencija ir privalomas šaltinio nurodymas

Duomenys gaunami iš Via Lietuva ir platinami pagal CC BY 4.0 licenciją. Kiekviename atsakyme yra attribution blokas. Jei duomenis rodote ar platinate, būtina nurodyti šaltinį, pavyzdžiui: 

Duomenys: Via Lietuva (ev.vialietuva.lt), CC BY 4.0; apdorojo ikrovimo-kaina.lt

Kiekviena stotelė ir tinklas turi url — nuorodą į atitinkamą mūsų puslapį. Ją ir pateikite šalia duomenų. Tesla Supercharger duomenys (source: "manual") surinkti rankiniu būdu iš tesla.com, ne iš Via Lietuva, ir jų užimtumas nežinomas (evses_available: null).

Užklausos

GET /stations

Stotelės su kainomis, galia, jungtimis ir laisvomis vietomis. Filtrai: lat, lng, radius_km (≤ 50), city, operator, power (ac|dc|hpc|fast), standard, max_price, available, limit (≤ 200), cursor.

curl 'https://ikrovimo-kaina.lt/api/v1/stations?city=vilnius&power=dc&limit=10'

GET /stations/{id}

Viena stotelė: įkrovimo taškų būsenos, jungtys ir visos tarifo dedamosios.

curl 'https://ikrovimo-kaina.lt/api/v1/stations/21'

GET /operators

Įkrovimo tinklai: stotelių skaičius, AC / DC / HPC pigiausia ir tipinė kaina.

curl 'https://ikrovimo-kaina.lt/api/v1/operators'

GET /operators/{slug}

Vienas tinklas.

curl 'https://ikrovimo-kaina.lt/api/v1/operators/in-balance-grid-uab'

GET /cities

Miestai: stotelių skaičius, pigiausia ir mediana kaina.

curl 'https://ikrovimo-kaina.lt/api/v1/cities'

GET /prices/summary

Nacionalinė santrauka: stotelių skaičiai ir AC / DC / HPC kainos.

curl 'https://ikrovimo-kaina.lt/api/v1/prices/summary'

GET /prices/history

Dienos vidutinės AC ir DC kainos: visos Lietuvos, tinklo (operator) arba stotelės (station); days ≤ 365.

curl 'https://ikrovimo-kaina.lt/api/v1/prices/history?operator=in-balance-grid-uab&days=30'

GET /route

Stotelės maršruto koridoriuje tarp dviejų vietų (from, to — pavadinimas arba „lat,lng“), corridor_km ≤ 10.

curl 'https://ikrovimo-kaina.lt/api/v1/route?from=Vilnius&to=Klaip%C4%97da&corridor_km=2'

GET /electricity/today

Nord Pool biržos elektros kaina Lietuvoje šiandien ir rytoj kas valandą, ct/kWh be PVM.

curl 'https://ikrovimo-kaina.lt/api/v1/electricity/today'

GET /openapi.json

OpenAPI 3.1 specifikacija.

curl 'https://ikrovimo-kaina.lt/api/v1/openapi.json'

Atsakymo formatas

{
  "data": …,
  "meta": { "updated_at": "2026-09-14T06:00:00+00:00", "count": 10, "total": 412, "next_cursor": "bzoxMA" },
  "attribution": { "text": "…", "license": "CC-BY-4.0", "license_url": "…", "source_url": "…" }
}
  • Matavimo vienetai nurodyti lauko pavadinime: price_eur_kwh, max_power_kw, price_ct_kwh.
  • Įkrovimo kainos yra su PVM (vat_included: true); Nord Pool biržos kaina — be PVM.
  • null reiškia „nėra duomenų“, niekada ne 0.
  • Datos ir laikas — ISO 8601.
  • Kitam puslapiui perduokite meta.next_cursor kaip ?cursor=.
  • Klaidos: {"error": {"code": "invalid_parameter", "message": "…"}} su HTTP būsena 400, 404, 429 arba 503.

Užklausų limitai

  • 60 užklausų per minutę iš vieno IP adreso.
  • /route: 10 per minutę — maršrutą skaičiuoja bendrai naudojamas OSRM serveris, todėl jam laikinai neveikiant grąžinama 503.
  • Likutis nurodomas antraštėse X-RateLimit-Limit ir X-RateLimit-Remaining; viršijus limitą — 429 ir Retry-After.
  • Atsakymai talpinami (Cache-Control, ETag): siųskite If-None-Match, kad gautumėte 304. Dažniau nei kas 5 minutes užklausti prasmės nėra.

Stabilumo pažadas

v1 laukai ir parametrai nebus pašalinti ar pervadinti. Gali atsirasti naujų laukų, todėl nežinomus laukus ignoruokite. Nesuderinami pakeitimai būtų tik naujoje versijoje (/api/v2), o v1 dar kurį laiką veiktų kartu.

MCP serveris AI agentams

Tuos pačius duomenis galima naudoti ir per MCP (Model Context Protocol) — tada Claude, ChatGPT, Cursor ir kiti AI asistentai gali atsakyti, pavyzdžiui, „kur pigiausia įkrauti Kaune?“ su šiandienos kainomis ir nuoroda į šaltinį. Serveris nemokamas ir be rakto, tik skaitymui.

Adresas (Streamable HTTP): https://ikrovimo-kaina.lt/mcp

  • Įrankiai: find_stations, cheapest_charging, operator_tariffs, charging_cost, price_changes, electricity_price.
  • Claude: Settings → Connectors → Add custom connector, įklijuokite adresą.
  • Limitas: 60 užklausų per minutę iš vieno IP adreso. Licencija ir šaltinio nurodymas — tokie patys kaip API.

Kontaktai

Klausimai, pasiūlymai ar didesnio užklausų kiekio poreikis: [email protected]. Metodika ir PVM prielaidos — duomenų šaltinio puslapyje.

In English

A free, keyless, read-only JSON API for public EV charging in Lithuania: stations with live availability, networks, AC / DC / HPC prices (incl. VAT) with daily history, stations along a driving route, and Nord Pool LT hourly electricity prices. CORS is open. The machine-readable contract is the OpenAPI 3.1 spec; base URL https://ikrovimo-kaina.lt/api/v1.

  • License: data from Via Lietuva under CC BY 4.0. Keep the credit from each response's attribution block and link the url of what you show.
  • Rate limits: 60 requests/min per IP, 10/min on /route; 429 with Retry-After beyond that.
  • Conventions: units in key names, null means no data, ISO 8601 dates, cursor pagination via meta.next_cursor, errors as {"error": {"code", "message"}}.
  • Stability: v1 fields and parameters are never removed or renamed; new ones may be added, so ignore unknown fields.
  • MCP server for AI agents: https://ikrovimo-kaina.lt/mcp (Streamable HTTP, no auth, read-only; 60 requests/min per IP). Tools: find_stations, cheapest_charging, operator_tariffs, charging_cost, price_changes, electricity_price. Add it in Claude as a custom connector, or in ChatGPT and Cursor as a remote MCP server.
  • Contact: [email protected]
curl 'https://ikrovimo-kaina.lt/api/v1/prices/summary'