Tools (5)

get_carbon_intensity
get_grid_mix
forecast_intensity
find_greenest_region
report_feedback

get_carbon_intensity

Get the carbon intensity of electricity production for a grid zone.

Carbon intensity measures how much CO₂-equivalent is emitted per kWh of electricity
consumed, expressed in gCO₂eq/kWh. Lower is greener.

Args:
zone: Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO").
See https://app.electricitymaps.com for a full list of zone codes.
datetime: Optional ISO 8601 datetime string to look up historical intensity.
If omitted, returns the latest available value.
Historical data covers approximately the past 24 hours.

Returns:
Carbon intensity in gCO₂eq/kWh with zone, timestamp, and estimation metadata.

Parameter	Type	Required	Description
`zone`	`string`	required	Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO"). See https://app.electricitymaps.com for a full list of zone codes.
`datetime`	`any`	optional	Optional ISO 8601 datetime string to look up historical intensity. If omitted, returns the latest available value. Historical data covers approximately the past 24 hours.

Request Body

{
  "zone": "example"
}

get_grid_mix

Get the current electricity production breakdown by energy source for a grid zone.

Shows how electricity is being generated right now — what percentage comes from
renewables, fossil fuels, nuclear, etc. Useful for understanding a region's
energy profile or for EU CSRD Scope 2 emissions reporting.

Args:
zone: Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO").

Returns:
Production breakdown by source (MW), total production, renewable percentage,
fossil-free percentage, and IPCC lifecycle emission factor per source.

Parameter	Type	Required	Description
`zone`	`string`	required	Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO").

Request Body

{
  "zone": "example"
}

forecast_intensity

Get predicted carbon intensity for a grid zone over the coming hours.

Forecasts are generated by Electricity Maps based on weather models and
scheduled generation. Useful for scheduling compute workloads, EV charging,
or other deferrable energy consumption to lower-carbon windows.

Args:
zone: Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO").
hours_ahead: How many hours of forecast to return (1–48, default 24).

Returns:
Hourly forecast entries with predicted carbon intensity in gCO₂eq/kWh.

Parameter	Type	Required	Description
`zone`	`string`	required	Electricity Maps zone code (e.g. "NO", "DE", "FR", "GB", "US-CAL-CISO").
`hours_ahead`	`integer`	optional	How many hours of forecast to return (1–48, default 24). (default: 24)

Request Body

{
  "zone": "example"
}

find_greenest_region

Compare carbon intensity across multiple grid zones and rank them by greenness.

Useful for routing compute workloads, data center jobs, or EV charging to the
cleanest available grid. Lower carbon intensity = greener electricity.

Args:
zones: List of Electricity Maps zone codes to compare
(e.g. ["NO", "SE", "FI", "DE", "FR"]).
window_hours: Averaging window in hours (1 = current value, default 1).
Values > 1 average over recent history for a smoother signal.

Returns:
Zones ranked from greenest to most carbon-intensive, with intensity values
and the recommended zone for low-carbon scheduling.

Parameter	Type	Required	Description
`zones`	`list[string]`	required	List of Electricity Maps zone codes to compare (e.g. ["NO", "SE", "FI", "DE", "FR"]).
`window_hours`	`integer`	optional	Averaging window in hours (1 = current value, default 1). Values > 1 average over recent history for a smoother signal. (default: 1)

Request Body

{
  "zones": [
    "example"
  ]
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/electricity-maps/get_carbon_intensity" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"zone": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/electricity-maps/get_carbon_intensity",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "zone": "example"
},
)
print(resp.json())