Api Endpoint

GridHub Electricity Data

Interpretation-ready snapshot of one electricity zone: current wholesale price and demand (plus carbon intensity for GB) each ranked against the zone's own trailing 30-day distribution, 24h trend, and a one-sentence summary. Use for 'is power cheap or expensive in {zone} right now'. Zone ids from /v1/zones.

Open interactive test console

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/brief/:zone
MIME type
application/json
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
electricity, energy, Prices, grid, Brief

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x7ca97aE70E38736a94eEa00427D50846Bab978DD"
  }
]

Observed health

Status
Healthy
Latest latency
105 ms
Average latency
203 ms
HTTP status
402
Last checked
Reachability
100% 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": {
        "sample": {
          "type": "string",
          "enum": [
            "true"
          ],
          "description": "Free truncated sample, no payment or credentials"
        }
      }
    }
  },
  "required": [
    "type",
    "method",
    "pathParams"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "pathParams": {
          "properties": {
            "zone": {
              "description": "Zone id from /v1/zones",
              "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"
              ],
              "type": "string"
            }
          },
          "required": [
            "zone"
          ],
          "type": "object"
        },
        "queryParams": {
          "properties": {
            "sample": {
              "description": "Free truncated sample, no payment or credentials",
              "enum": [
                "true"
              ],
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "pathParams"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "as_of": {
              "type": [
                "number",
                "null"
              ]
            },
            "attribution": {
              "type": [
                "string",
                "null"
              ]
            },
            "context": {
              "additionalProperties": {
                "properties": {
                  "max": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "median": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "min": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "percentile": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "sample_count": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "unit": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "vs_median_pct": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "window_days_actual": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "type": [
                "object",
                "null"
              ]
            },
            "context_window_requested_days": {
              "type": [
                "number",
                "null"
              ]
            },
            "coverage_note": {
              "type": [
                "string",
                "null"
              ]
            },
            "current": {
              "additionalProperties": {
                "properties": {
                  "ts": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "unit": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "value": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "type": [
                "object",
                "null"
              ]
            },
            "license": {
              "type": [
                "string",
                "null"
              ]
            },
            "summary": {
              "type": [
                "string",
                "null"
              ]
            },
            "zone": {
              "type": [
                "string",
                "null"
              ]
            },
            "zone_name": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}