{"uid":"cap_3WtRx1Qly7G7x1SNagLCa","slug":"gridhub-live-electricity-market-brief-15ef57d5","name":"GridHub Live Electricity Market Brief","description":"Live wholesale electricity prices, demand, and generation mix across 25 grids in the US, UK, Australia, and Europe. Pay-per-call API access from $0.001.","url":"https://api.grid-hub.app/v1/brief/%7Bzone%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["zone"],"properties":{"zone":{"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","description":"Zone id from /v1/zones"}}},"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":{"zone":"GB","context":{"price":{"unit":"GBP/MWh","value":88.76,"percentile":82}},"summary":"Price is high (82nd percentile); demand is normal."}},"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-09-14T18:41:21.274Z","isFirstParty":false}