GridHub Electricity Market Data
Historical demand time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones.
Offering
- Provider
- api.grid-hub.app
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Financial Analysis
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.grid-hub.app/v1/demand/GB- MIME type
- application/json
- First seen
- 2026-10-16T03:04:46.000Z
- Last seen
- Tags
- electricity, energy, demand, grid, history, MCP, X402
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0x7ca97aE70E38736a94eEa00427D50846Bab978DD"
}
]Observed health
- Status
- Healthy
- Latest latency
- 94 ms
- Average latency
- 896 ms
- HTTP status
- 402
- Last checked
- Reachability
- 92.9% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET"
]
},
"pathParams": {
"type": "object",
"properties": {
"zone": {
"type": "string",
"enum": [
"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"
],
"description": "Zone id from /v1/zones"
}
},
"required": [
"zone"
]
},
"queryParams": {
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Window start, Unix seconds"
},
"end": {
"type": "string",
"description": "Window end, Unix seconds"
},
"limit": {
"type": "string",
"description": "Max rows (up to 5000)"
},
"sample": {
"type": "string",
"enum": [
"true"
],
"description": "Free truncated sample, no payment or credentials"
}
}
}
},
"required": [
"type",
"method",
"pathParams"
],
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"zone": {
"type": [
"string",
"null"
]
},
"metric": {
"type": [
"string",
"null"
]
},
"start": {
"type": [
"number",
"null"
]
},
"end": {
"type": [
"number",
"null"
]
},
"count": {
"type": [
"number",
"null"
]
},
"attribution": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"metric": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"ts": {
"type": [
"number",
"null"
]
},
"value": {
"type": [
"number",
"null"
]
},
"unit": {
"type": [
"string",
"null"
]
},
"resolution": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
},
"required": [
"type"
]
}