⚡ 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-NY · CA-ON · JP (9 zones) · MX (14 zones)

Spot price only: KR · KR-JEJU · ZA (regulated) · PH-LUZ · PH-VIS · PH-MIN (regulated) · US-TX (ERCOT — day-ahead data requires authenticated access, not yet integrated)

Connect in 30 seconds

Claude / Claude Code / any MCP client

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

Full setup guide for every MCP client: elecz.com/electricity-price-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/spot?zone=ZA"
curl "https://elecz.com/signal/spot?zone=MX-MTY"
curl "https://elecz.com/signal/cheapest-hours?zone=DE&hours=5"
curl "https://elecz.com/signal?zone=GB&consumption=2700"

MCP Tools

Tool	When to use	Returns
`spot_price`	User asks what electricity costs right now	Current price in local unit
`cheapest_hours`	When to run appliances, charge EV, schedule tasks	Cheapest slots + best window next 24h. Full field reference →
`best_energy_contract`	Which contract options are available, savings estimate	Best spot + best fixed + recommendation

REST API

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

Endpoint	Description
`GET /signal/spot?zone=DE`	Current spot price only
`GET /signal/cheapest-hours?zone=DE&hours=5`	Cheapest hours next 24h
`GET /signal/contract?zone=DE&consumption=3500`	Contract options and switching recommendation
`GET /signal?zone=DE&consumption=3500`	Full signal with contract recommendations
`GET /go/<provider>`	Redirect to provider
`GET /health`	Health check
`GET /signal/optimize?zone=DE`	Deprecated — use /signal

Supported Markets

Zone	Spot	Cheapest Hours	Contracts	Source
FI, SE (SE1–SE4), NO (NO1–NO5), DK (DK1–DK2), DE	✓	✓	✓	ENTSO-E
GB (+ regional GB-A..GB-P)	✓	✓	✓	Octopus Agile
AU-NSW, AU-VIC, AU-QLD, AU-SA, AU-TAS	✓	—	✓	AEMO NEM
NZ-NI, NZ-SI	✓	—	✓	EM6
NL, BE, AT, FR, IT (6 zones), PL, CZ, HU, RO, IE	✓	✓	—	ENTSO-E
ES, PT, HR, BG, SI, SK, GR	✓	✓	—	ENTSO-E
EE, LV, LT, CH, RS, BA, ME, MK	✓	✓	—	ENTSO-E
US-CA-NP15, US-CA-SP15, US-CA-ZP26	✓	✓	—	CAISO OASIS
US-TX-HB_NORTH/HOUSTON/SOUTH/WEST/HUBAVG, US-TX-LZ_*	✓	—	—	ERCOT CDR
US-NY-* (11 zones)	✓	✓	—	NYISO MIS
CA-ON	✓	✓	—	IESO
KR, KR-JEJU	✓	—	—	KPX EPSIS
JP-HKD, JP-THK, JP-TKY, JP-CBU, JP-HKR, JP-KNS, JP-CGK, JP-SKK, JP-KYS	✓	✓	—	JEPX
ZA (South Africa)	✓	—	—	Eskom regulated
PH-LUZ, PH-VIS, PH-MIN (Philippines)	✓	—	—	Meralco/ERC regulated
MX-AGS, MX-MTY, MX-GDL, MX-PUE, MX-VER, MX-CHH, MX-HMO, MX-MID, MX-CUL, MX-LEO, MX-QRO, MX-MLM, MX-OAX, MX-CUN	✓	✓	—	CENACE MDA

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 options

"What are the best electricity contract options for a household using 2700 kWh/year in the UK?"

Japan

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

South Africa

"What is the electricity tariff in Cape Town?"

Mexico

"When is electricity cheapest in Monterrey today?"

More worked examples and prompt patterns: elecz.com/for-agents

United Kingdom

Spot prices from Octopus Agile — based on day-ahead wholesale auctions. The full set of 48 half-hourly rates for the next day is published once, typically around 16:00 UK time; Elecz refreshes its data shortly after. Within a day, the published rate changes every 30 minutes by design — but no new data is published intraday. 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. The NEM dispatches and prices the market every 5 minutes (DISPATCHPRICE) — Elecz fetches this data on the same 5-minute cadence. 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)

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 ERCOT CDR. cheapest_hours currently returns available: false — ERCOT's day-ahead market requires authenticated API access (OAuth token), which is not yet integrated. 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.

South Africa

Eskom Homepower regulated tariff. Unit: ZAR c/kWh (VAT excl). NERSA-approved, updated annually 1 April.

Zone: ZA · price_type: regulated — not a spot market price. cheapest_hours not available — fixed tariff.

Philippines

Meralco regulated tariff (PH-LUZ) and ERC representative rates (PH-VIS, PH-MIN). Unit: PHP c/kWh (VAT incl). Updated monthly ~13th.

Zones: PH-LUZ (Luzon/Metro Manila) · PH-VIS (Visayas) · PH-MIN (Mindanao)

Note: price_type: regulated. cheapest_hours not available.

Mexico

CENACE MDA (day-ahead) wholesale prices. Unit: MXN/kWh. Updated daily. cheapest_hours available.

14 zones: MX-AGS · MX-MTY · MX-GDL · MX-PUE · MX-VER · MX-CHH · MX-HMO · MX-MID · MX-CUL · MX-LEO · MX-QRO · MX-MLM · MX-OAX · MX-CUN

Note: Wholesale prices only. Retail via CFE includes distribution charges and subsidies.

Roadmap

✅ Nordic markets (FI, SE, NO, DK)
✅ Germany (DE)
✅ United Kingdom (GB)
✅ Australia (AEMO NEM)
✅ New Zealand (EM6)
✅ Southern Europe (ES, PT, HR, BG, SI, SK, GR)
✅ Balkans + Switzerland (CH, RS, BA, ME, MK)
✅ Baltics (EE, LV, LT)
✅ Ireland (IE — SEM)
✅ United States — CAISO, ERCOT, NYISO
✅ Canada — Ontario (IESO)
✅ South Korea (KPX EPSIS)
✅ Japan — 9 zones (JEPX)
✅ South Africa (Eskom regulated)
✅ Philippines (Meralco/ERC regulated)
✅ Mexico — 14 zones (CENACE MDA)
🔜 Netherlands, Belgium — contract comparison

Support

Questions or integrations: [email protected] · GitHub