v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Energy

Grid operating data (EIA-930 / Elexon BMRS / NESO / Energinet / ENTSO-E / AEMO)

Grid operating data, provider-resolved by region: US balancing authorities (EIA respondent code, e.g. US48, PJM, CISO, ERCO) from the EIA-930 Hourly Electric Grid Monitor; GB from Elexon Insights (BMRS - demand outturn, day-ahead forecast) plus NESO (carbon intensity actual/forecast, embedded wind/solar forecast), half-hourly; DK1/DK2 from Energinet (hourly - demand, co2_intensity). DE_LU, FR, NL, ES, IT_NORD and PL from ENTSO-E Transparency at the published native resolution (demand and EUR/MWh day-ahead price). Operational data, preliminary and subject to revision; not for real-time grid operations.

get/api/v2/energy/grid

Query parameters

regionstring

Region code: EIA balancing authority (US48, PJM, ...), GB, DK1/DK2, ENTSO-E zone (DE_LU, FR, NL, ES, IT_NORD, PL), or AU NEM region.

Example:PJM

Region code: EIA balancing authority (US48, PJM, ...), GB, DK1/DK2, ENTSO-E zone (DE_LU, FR, NL, ES, IT_NORD, PL), or AU NEM region.

metric'demand' | 'demand_forecast' | 'net_generation' | 'total_interchange' | 'co2_intensity' | 'co2_intensity_forecast' | 'embedded_wind_forecast' | 'embedded_solar_forecast' | 'price'

demand | demand_forecast | net_generation | total_interchange | co2_intensity (GB/DK) | co2_intensity_forecast (GB) | embedded_wind_forecast (GB) | embedded_solar_forecast (GB) | price (AU NEM or ENTSO-E).

frequency'hourly' | 'local_hourly'

hourly (UTC) | local_hourly (local time). US regions only.

startstring nullable

Lower bound on period (ISO 8601 or EIA YYYY-MM-DDTHH).

Lower bound on period (ISO 8601 or EIA YYYY-MM-DDTHH).

endstring nullable

Upper bound on period.

Upper bound on period.

limitinteger

Maximum observations returned. History metrics: newest first. GB forecast metrics: nearest future periods first (chronological from now, or from an explicit start - pass a past start to read superseded forecast values).

Maximum observations returned. History metrics: newest first. GB forecast metrics: nearest future periods first (chronological from now, or from an explicit start - pass a past start to read superseded forecast values).

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "region": "PJM",
      "metric": "demand",
      "frequency": "hourly",
      "limit": 72
    },
    "region": "PJM",
    "region_name": "PJM Interconnection, LLC",
    "metric": "demand",
    "type_code": "D",
    "unit": "megawatthours",
    "resolution": "PT30M",
    "series": [
      {
        "period": "2026-07-04T05",
        "value": 95000
      }
    ],
    "attribution": {
      "sources": [
        {
          "registry_key": "eia/rto",
          "source_name": "EIA",
          "licence": "public-domain",
          "citation": "U.S. Energy Information Administration, Hourly Electric Grid Monitor (Form EIA-930)",
          "disclaimer": "Operational electric-grid data; preliminary and subject to revision."
        }
      ],
      "effective_reexport": "allowed"
    },
    "disclaimer": "Operational electric-grid data; preliminary and subject to revision."
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}