{"uid":"cap_NHyUqykG51YviHV1LbpCp","slug":"gridhub-electricity-zone-brief-bf6da923","name":"GridHub Electricity Zone Brief","description":"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.","url":"https://api.grid-hub.app/v1/brief/:zone","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":null,"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_2psBgS5Z3iSGemSRTmXYQ","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 an interpretation-ready snapshot of current wholesale price, demand, and carbon intensity (GB only) for a single electricity zone, each ranked against its trailing 30-day distribution with a 24-hour trend and a one-sentence human-readable summary.","exampleAgentPrompt":"Is electricity cheap or expensive in the CAISO zone right now? Give me a quick ranked summary of current price and demand versus the last 30 days.","exampleUseCases":[{"title":"Smart appliance scheduling trigger","prompt":"Check if power is cheap in the ERCOT zone right now — tell me where current wholesale prices rank against the past 30 days so I can decide whether to run my EV charger."},{"title":"Carbon-aware compute timing in GB","prompt":"What's the current carbon intensity in the GB electricity grid, and how does it compare to the last month? I want to know if now is a relatively clean time to run a heavy workload."},{"title":"Energy trading desk morning briefing","prompt":"Give me a quick brief on PJM electricity conditions right now — is wholesale price high or low relative to the trailing 30 days, and what's the 24-hour trend?"}],"resultDescription":"A structured snapshot containing current wholesale price, demand, and (for GB) carbon intensity, each with a percentile rank against the zone's trailing 30-day distribution, a 24-hour directional trend indicator, and a concise one-sentence natural language summary of overall grid conditions.","failureModes":["Invalid or unsupported zone ID returns an error — use /v1/zones to retrieve valid zone identifiers","Data may be temporarily unavailable if the upstream grid operator feed is delayed","Payment failure (x402) if USDC balance is insufficient or payment header is missing","Rate limiting if too many requests are made in a short window"],"whenToPreferThis":"Use this endpoint when you need a quick, human-interpretable assessment of whether electricity is cheap, expensive, or stressed in a specific zone — especially when you want context (percentile rank, trend, summary sentence) rather than raw numbers. Prefer this over the raw metrics endpoint when the goal is decision-making or natural language reporting. Use the historical endpoint instead when you need time-series data over days or weeks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:46.055Z","isFirstParty":false}