Api Endpoint

GridHub Electricity Data

Current headline values (price, demand, and where published carbon intensity) for all 25 GridHub zones in one call. Use to compare or rank grids right now; rebuilt every 5 minutes. For one zone with context use /v1/brief/{zone}.

Open interactive test console

Offering

Provider
api.grid-hub.app
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Weather And Environment
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.grid-hub.app/v1/map/snapshot
MIME type
application/json
First seen
2026-10-16T01:50:10.647Z
Last seen
Tags
electricity, energy, Prices, grid, Snapshot

Payment pricing

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

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

Observed health

Status
Healthy
Latest latency
73 ms
Average latency
425 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"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "sample": {
          "type": "string",
          "enum": [
            "true"
          ],
          "description": "Free truncated sample, no payment or credentials"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "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"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "generated": {
              "type": [
                "number",
                "null"
              ]
            },
            "zones": {
              "additionalProperties": {
                "properties": {
                  "attribution": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "license": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "metrics": {
                    "additionalProperties": {
                      "properties": {
                        "resolution": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "ts": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "unit": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "value": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      },
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "updated": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "zone": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "type": [
                "object",
                "null"
              ]
            }
          },
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}