⚡ Elecz Docs

Q: How do I know which zone code to use for a city?

Use the City → Zone Mapping table on this page. Multi-zone markets like Sweden, Norway, Denmark, the UK, Texas, New York, and Mexico can't be resolved from a country name alone — a city or region name is needed to pick the right zone.

Q: What's the difference between spot_price and cheapest_hours?

spot_price returns the current electricity price right now. cheapest_hours returns the cheapest upcoming slots in the next 24 hours, for scheduling EV charging, appliances, or automation.

"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

City → Zone Mapping for AI Agents

Many multi-zone markets cannot be resolved from a country name alone. Use this table to map a city or region the user mentions to the correct zone parameter. If a city isn't listed and the market has more than one zone, ask the user which region rather than guessing — see notes below each table.

Sweden (SE1–SE4) · Norway (NO1–NO5) · Denmark (DK1–DK2)

City / Region	Zone
Stockholm, Gothenburg	`SE3`
Malmö (Southern Sweden)	`SE4`
Sundsvall, Gävle (Northern-Central Sweden)	`SE2`
Northern Sweden (Luleå, Kiruna)	`SE1`
Oslo	`NO1`
Kristiansand (Southwest Norway)	`NO2`
Trondheim (Central Norway)	`NO3`
Northern Norway (Tromsø)	`NO4`
Bergen	`NO5`
Copenhagen (East Denmark)	`DK2`
Aarhus (West Denmark)	`DK1`

Denmark has only 2 zones with materially different prices. If the user just says "Denmark" without a city, ask which half rather than defaulting to one.

United Kingdom (GB-A .. GB-P)

City	Zone
London	`GB-C`
Manchester	`GB-G`
Birmingham	`GB-E`
Glasgow	`GB-N`
Edinburgh	`GB-N`
Cardiff	`GB-K`
Bristol	`GB-L`

If the regional DNO zone can't be inferred, use plain GB (London/region C rates).

Italy (6 zones)

City	Zone
Milan (North)	`IT-NO`
Florence (Centre-North)	`IT-CNO`
Naples (South)	`IT-SO`
Palermo (Sicily)	`IT-SIC`
Cagliari (Sardinia)	`IT-SAR`

Rome's exact sub-zone is unconfirmed — likely Centre-South (IT-CSO) rather than the national aggregate IT. Verify before relying on it.

United States — California (CAISO)

City	Zone
San Francisco (NorCal/PG&E)	`US-CA-NP15`
Los Angeles, San Diego (SoCal)	`US-CA-SP15`
Fresno, Bakersfield, Palm Springs (Desert/Central)	`US-CA-ZP26`

United States — Texas (ERCOT)

City	Zone
Dallas, Fort Worth	`US-TX-HB_NORTH`
Houston	`US-TX-HB_HOUSTON`
San Antonio, Austin	`US-TX-HB_SOUTH`
Midland, Odessa (wind zone — prices can go negative)	`US-TX-HB_WEST`

HB_* = wholesale trading hub, LZ_* = utility load zone — use HB_* unless the user specifically asks about a load-zone settlement point. El Paso is on the Western Interconnection, not ERCOT — not supported. cheapest_hours is not available for any Texas zone yet — confirmed via live testing: ERCOT day-ahead data requires OAuth access, not yet integrated. Only spot_price works for Texas today.

United States — New York (NYISO, 11 zones)

City	Zone
Manhattan, Brooklyn, Queens, Bronx, Staten Island	`US-NY-NYC`
Buffalo, Niagara Falls	`US-NY-WEST`
Rochester	`US-NY-GENESE`
Syracuse	`US-NY-CENTRL`
Watertown	`US-NY-NORTH`
Utica	`US-NY-MHK_VL`
Albany	`US-NY-CAPITL`
Poughkeepsie	`US-NY-HUD_VL`
Yonkers, White Plains	`US-NY-DUNWOD`
Long Island, Hempstead	`US-NY-LONGIL`

"New York" alone is not enough — the 11 zones have materially different prices. Ask which region if no city is given. US-NY-MILLWD is a small transmission-only zone in Westchester with no natural city name.

Mexico (CENACE, 14 zones)

City	Zone
Mexico City area	`MX-PUE`
Monterrey	`MX-MTY`
Guadalajara	`MX-GDL`
Cancún	`MX-CUN`
Hermosillo	`MX-HMO`
Aguascalientes	`MX-AGS`
Veracruz	`MX-VER`
Chihuahua	`MX-CHH`
Mérida	`MX-MID`
Culiacán	`MX-CUL`
León	`MX-LEO`
Querétaro	`MX-QRO`
Morelia	`MX-MLM`
Oaxaca	`MX-OAX`

Tijuana is not supported — Baja California runs an isolated grid, not part of CENACE's interconnected system.

Japan (JEPX, 9 zones) · South Korea · Philippines

City	Zone
Tokyo	`JP-TKY`
Osaka	`JP-KNS`
Nagoya	`JP-CBU`
Sapporo	`JP-HKD`
Fukuoka	`JP-KYS`
Seoul, Busan	`KR`
Jeju	`KR-JEJU`
Manila	`PH-LUZ`
Cebu	`PH-VIS`
Davao	`PH-MIN`

Full agent behavior spec and zone heuristics: AGENT_SPEC.md on GitHub.

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)
✅ AI agent city → zone mapping (Sweden, Norway, Denmark, UK, Italy, California, Texas, New York, Mexico, Japan/Korea/Philippines)
🔜 Netherlands, Belgium — contract comparison
🔜 UK regional zones (GB-A..GB-P) in public openapi.json enum

Frequently Asked Questions

How do I know which zone code to use for a city?

Use the City → Zone Mapping table above. Multi-zone markets like Sweden, Norway, Denmark, the UK, Texas, New York, and Mexico can't be resolved from a country name alone — a city or region name is needed to pick the right zone.

Does the Elecz API require an API key?

No. Elecz is a free, public API with no authentication and no rate limit for reasonable use.

What's the difference between spot_price and cheapest_hours?

spot_price returns the current electricity price right now. cheapest_hours returns the cheapest upcoming slots in the next 24 hours, for scheduling EV charging, appliances, or automation.

Why doesn't cheapest_hours work for Texas (ERCOT)?

ERCOT's day-ahead market requires authenticated API access (OAuth token) that Elecz hasn't integrated yet. Texas currently supports spot_price only.

How many countries and zones does Elecz cover?

40+ countries and 100+ zones across Europe, the Americas, Asia, and Africa — including sub-national markets like Sweden's 4 price zones, Italy's 6 zones, New York's 11 NYISO zones, and Mexico's 14 CENACE zones.

Support

Questions or integrations: [email protected] · GitHub