Historical demand

Demand (MW) time series for one zone. Priced at $0.01 per call, payable via x402 (USDC on Base), or free with ?sample=true.

get/v1/demand/{zone}

Request

  • Base URL: https://api.grid-hub.app
  • URL: https://api.grid-hub.app/v1/demand/{zone}
  • Auth: none declared

Path parameters

zone'US-CAISO' | 'US-ERCOT' | 'US-PJM' | 'US-MISO' | 'US-NYISO' | 'US-ISONE' | 'US-SPP' | 'GB' | 'AU-NSW' | 'AU-QLD' | 'AU-VIC' | 'AU-SA' | 'AU-TAS' | 'DE-LU' | 'FR' | 'ES' | 'IT-NO' | 'NL' | 'BE' | 'PL' | 'SE-3' | 'NO-2' | 'DK-1' | 'AT' | 'CH' required

Zone identifier — see GET /v1/zones for the full list.

Query parameters

startinteger

Unix seconds. Defaults to 24h before now.

endinteger

Unix seconds. Defaults to now.

limitinteger

Max rows returned. Default 1000.

sampleboolean

Set to true for a free, truncated sample response with no credentials or payment (history capped at 50 rows).

Response

Success

zonestring
metricstring
startinteger
endinteger
countinteger
attributionstring
licensestring

Changes

No recorded changes to this operation across all 1 revision of this API.