⚡ Elecz Docs

"Electricity price is not content. It's an input."

Real-time electricity price signal for LLMs and AI agents. 40 countries, 100+ zones, no API key.

Free No API Key MCP-Native REST

What is Elecz?

Elecz turns real-time electricity prices into actionable signals — for AI agents, home automation, and anyone whose decisions depend on when they use electricity.

A language model cannot know the current electricity price. It was trained on historical data. Without a real-time API call, any answer it gives is a guess. Elecz is that call.

Contract comparison: FI · SE · NO · DK · DE · GB · AU · NZ

Spot price + cheapest hours: All of the above + NL · BE · AT · FR · IT · PL · CZ · HU · RO · ES · PT · HR · BG · SI · SK · GR · EE · LV · LT · CH · RS · BA · ME · MK · IE · US-CA · US-TX · US-NY · CA-ON · KR · JP (9 zones)

Connect in 30 seconds

Claude / Claude Code / any MCP client

{
  "mcpServers": {
    "elecz": {
      "url": "https://elecz.com/mcp"
    }
  }
}

cURL

curl "https://elecz.com/signal/spot?zone=DE"
curl "https://elecz.com/signal/spot?zone=US-NY-NYC"
curl "https://elecz.com/signal/spot?zone=JP-TKY"
curl "https://elecz.com/signal/spot?zone=AU-NSW"
curl "https://elecz.com/signal/cheapest-hours?zone=DE&hours=5"
curl "https://elecz.com/signal?zone=GB&consumption=2700"

MCP Tools

ToolWhen to useReturns
spot_priceUser asks what electricity costs right nowCurrent price in local unit
cheapest_hoursWhen to run appliances, charge EV, schedule tasksCheapest slots + best window next 24h
best_energy_contractWhich contract to choose or whether to switchBest spot + fixed contract + recommendation

REST API

Base URL: https://elecz.com — No authentication. No rate limit for reasonable use.

EndpointDescription
GET /signal/spot?zone=DECurrent spot price only
GET /signal/cheapest-hours?zone=DE&hours=5Cheapest hours next 24h
GET /signal?zone=DE&consumption=3500Full signal with contract recommendations
GET /go/<provider>Redirect to provider
GET /healthHealth check
GET /signal/optimize?zone=DEDeprecated — use /signal

Supported Markets

ZoneSpotCheapest HoursContractsSource
FI, SE (SE1–SE4), NO (NO1–NO5), DK (DK1–DK2), DEENTSO-E
GB (+ regional GB-A..GB-P)Octopus Agile
AU-NSW, AU-VIC, AU-QLD, AU-SA, AU-TASAEMO NEM
NZ-NI, NZ-SIEM6
NL, BE, AT, FR, IT, PL, CZ, HU, RO, IEENTSO-E
ES, PT, HR, BG, SI, SK, GRENTSO-E
EE, LV, LT, CH, RS, BA, ME, MKENTSO-E
US-CA-NP15, US-CA-SP15, US-CA-ZP26CAISO OASIS
US-TX-HB_NORTH/HOUSTON/SOUTH/WEST/HUBAVG, US-TX-LZ_*ERCOT CDR
US-NY-WEST/GENESE/CENTRL/NORTH/MHK_VL/CAPITL/HUD_VL/MILLWD/DUNWOD/NYC/LONGILNYISO MIS
CA-ONIESO
KR, KR-JEJUKPX EPSIS
JP-HKD, JP-THK, JP-TKY, JP-CBU, JP-HKR, JP-KNS, JP-CGK, JP-SKK, JP-KYSJEPX

Examples

Current price

"What is the current electricity price in Germany?"

Cheapest hours

"When should I charge my EV tonight? I'm in Texas."

Contract comparison

"Should I switch my electricity contract? I use about 2700 kWh/year in the UK."

Japan

"What is the electricity price in Tokyo right now?"

South Korea

"What is the current electricity price in Seoul?"

United Kingdom

Spot prices from Octopus Agile API — half-hourly resolution, updated every 30 min. Unit: p/kWh incl. VAT (5%).

Default zone GB = London (region C). Regional zones: GB-A through GB-P.

Germany

Spot prices from ENTSO-E. Contract comparison includes major providers. Unit: EUR c/kWh.

Note: Price excludes regional Netzentgelt (varies ~10–15 ct/kWh by area).

Ireland

SEM (Single Electricity Market). ENTSO-E zone IE. Spot price and cheapest hours available. Unit: EUR c/kWh.

Australia

Spot prices from AEMO — 5-minute NEM dispatch prices, updated every 30 min. Unit: AUD c/kWh.

Zones: AU-NSW · AU-VIC · AU-QLD · AU-SA · AU-TAS

Note: cheapest_hours returns available: false — no public day-ahead data for AU.

New Zealand

Spot prices from EM6 real-time API — NZEM wholesale prices, 30-min trading periods. Unit: NZD c/kWh.

Zones: NZ-NI (North Island) · NZ-SI (South Island)

Note: No spot pass-through retailers currently available. Flick Electric was acquired by Meridian Energy (July 2025).

United States

Three ISOs supported. All prices are wholesale — retail rates include transmission, distribution, and taxes on top.

California — CAISO

Day-ahead market (DAM), updated daily after 22:00 UTC. Unit: USD c/kWh.

Zones: US-CA-NP15 (NorCal/PG&E) · US-CA-SP15 (SoCal/SCE+SDG&E) · US-CA-ZP26 (Desert/Central)

Texas — ERCOT

Real-time 15-min data from public CDR. cheapest_hours uses DAM data (updated 18:30 UTC). Unit: USD c/kWh.

HB_WEST is the wind zone — prices can go negative.

Hubs: US-TX-HB_NORTH/HOUSTON/SOUTH/WEST/HUBAVG · Load zones: US-TX-LZ_NORTH/HOUSTON/SOUTH/WEST

New York — NYISO

Real-time 5-min data. cheapest_hours uses DAM data (updated 17:00 UTC). Unit: USD c/kWh.

11 zones: WEST · GENESE · CENTRL · NORTH · MHK_VL · CAPITL · HUD_VL · MILLWD · DUNWOD · NYC · LONGIL

Canada — Ontario

IESO real-time 5-min Ontario Zonal Price. cheapest_hours uses DAM data (updated 19:00 UTC). Unit: CAD c/kWh.

Zone: CA-ON

South Korea

SMP (System Marginal Price) from KPX EPSIS — ex-post actual hourly price (~1h lag). Unit: KRW/kWh.

Zones: KR (mainland) · KR-JEJU (Jeju Island)

Note: cheapest_hours returns available: false — no public day-ahead data. Regulated KEPCO retail market — no contract comparison.

Japan

JEPX day-ahead spot prices via japanesepower.org. Published daily ~10:30 JST. Unit: JPY/kWh.

9 zones: JP-HKD (Hokkaido) · JP-THK (Tohoku) · JP-TKY (Tokyo) · JP-CBU (Chubu) · JP-HKR (Hokuriku) · JP-KNS (Kansai) · JP-CGK (Chugoku) · JP-SKK (Shikoku) · JP-KYS (Kyushu)

Note: cheapest_hours available. No contract comparison.

Roadmap

Support

Questions or integrations: [email protected] · GitHub