{"uid":"cap_uG-rVqyuqyJcTh3lN2oOv","slug":"gridhub-map-snapshot-all-zones-e35c88be","name":"GridHub Map Snapshot – All Zones","description":"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}.","url":"https://api.grid-hub.app/v1/map/snapshot","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"sample":{"enum":["true"],"type":"string","description":"Free truncated sample, no payment or credentials"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"zones":{"GB":{"price":{"unit":"GBP/MWh","value":88.76},"demand":{"unit":"MW","value":23655}}},"updated":1788017168}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nT1X5eDWT9zcbKa_JHxJ5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current electricity price, demand, and carbon intensity for all 25 GridHub zones in a single call, refreshed every 5 minutes.","exampleAgentPrompt":"Pull the latest GridHub snapshot and tell me which of the 25 zones has the cheapest wholesale electricity price and the lowest carbon intensity right now.","exampleUseCases":[{"title":"Cheapest grid for compute workload","prompt":"Which GridHub zone has the lowest electricity price right now? I want to know where to route my energy-intensive compute job to minimize costs."},{"title":"Greenest grid for sustainability reporting","prompt":"Give me the current carbon intensity for all GridHub zones and tell me which region is running the cleanest electricity mix at this moment."},{"title":"Real-time grid demand comparison","prompt":"Show me the live demand levels across all 25 GridHub zones so I can see which grids are most and least stressed right now."}],"resultDescription":"A JSON array covering all 25 GridHub zones, each entry containing the current wholesale electricity price, demand level, and (where published) carbon intensity value, with data no older than 5 minutes.","failureModes":["Data temporarily unavailable if GridHub's 5-minute rebuild cycle is interrupted","Individual zones may omit carbon intensity if the zone does not publish that metric","Payment failure (x402) if USDC balance is insufficient or wallet is not configured","Rate limiting if the endpoint is called too frequently within a short window"],"whenToPreferThis":"Use this endpoint when you need to compare or rank multiple electricity zones simultaneously in a single call. If you only need data for one specific zone with additional context, use /v1/brief/{zone} instead. This endpoint is ideal for dashboards, cross-zone optimization decisions, or any workflow that needs to evaluate all 25 zones at once without making 25 separate requests.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:41:46.026Z","isFirstParty":false}