{"uid":"cap_3WtRx1Qly7G7x1SNagLCa","slug":"gridhub-live-electricity-market-brief-15ef57d5","name":"GridHub Live Electricity Market Brief","description":"Live wholesale electricity prices and demand across 25 grids in the US, UK, Australia, and Europe, in one JSON schema. Free API key or pay-per-call from $0.001.","url":"https://api.grid-hub.app/v1/brief/%7Bzone%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"zone":"GB","as_of":1790496611,"context":{"price":{"max":246.58,"min":-23.28,"unit":"GBP/MWh","median":146.23,"percentile":43,"sample_count":1424,"vs_median_pct":-2.9,"window_days_actual":29.6}},"current":{"price":{"ts":1790467200,"unit":"GBP/MWh","value":141.97},"demand":{"ts":1790494200,"unit":"MW","value":20878}},"license":"NESO-Open-Licence","summary":"For Great Britain, price is typical (43rd percentile over the last 29.6 days); carbon intensity is typical (34th percentile); demand is typical; wind is the largest generation source at 54.3% of the mix.","zone_name":"Great Britain","attribution":"Supported by National Energy SO Open Data","coverage_note":"Context blocks are omitted for metrics this zone doesn't publish or where fewer than 20 samples exist. window_days_actual reflects the real data span, which varies by zone and metric. \"current\" is the most recent point at or before reque...","context_window_requested_days":30}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Re5m06hB-F3v0E3eBT0BX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a concise, interpretation-ready snapshot of current wholesale electricity price, demand, and generation mix for a specified grid zone, with a percentile ranking for context.","exampleAgentPrompt":"What's the current wholesale electricity price in Great Britain right now, and is it high or low compared to normal?","exampleUseCases":[{"title":"Smart home load-shifting automation","prompt":"Check the current electricity price in CAISO — if it's below the 30th percentile, go ahead and start the EV charger and dishwasher."},{"title":"Energy cost dashboard for operators","prompt":"Pull the live wholesale electricity price and demand level for PJM and tell me where we stand percentile-wise so I can update the dashboard."},{"title":"Sustainability reporting context","prompt":"What's the current electricity price and grid conditions in Germany right now? I need it for a quick sustainability briefing."}],"resultDescription":"A JSON object containing the zone identifier, current wholesale price with unit and percentile ranking, demand status, and a short natural-language summary sentence (e.g. 'Price is high (82nd percentile); demand is normal.') — designed to be directly readable by a human or agent without further processing.","failureModes":["Invalid zone identifier returns a 400/422 error — only the 25 supported zone enum values are accepted","Upstream grid data unavailability may return a 503 or stale/null values for some metrics","Payment not included or insufficient (x402 protocol) results in a 402 Payment Required response","Rate limiting or quota exhaustion may return a 429 error"],"whenToPreferThis":"Choose this endpoint when you need a fast, human-readable snapshot of current electricity market conditions for a specific grid zone — especially when you want the price in context (percentile ranking + plain-language summary) rather than raw numbers. Prefer this over the full snapshot endpoint when brevity matters, and over the historical endpoint when only real-time conditions are needed. Ideal for decision-making triggers (e.g. load shifting, cost alerts) and dashboard summaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:30:14.350Z","isFirstParty":false,"canonicalSlug":"gridhub-live-electricity-market-brief-15ef57d5"}