{"uid":"cap_NzalElzS9O91v4HqEfsUH","slug":"truthbear-grid-reliability-region-gauge-7557300c","name":"TruthBear Grid Reliability Region Gauge","description":"[3-LEG] Grid reliability chain, one balancing authority (?entity=us-ercot): leading EIA-930 day-ahead demand forecast approaching recent peak, about one day of lead -> current current demand against capacity tightness -> realized reserve and interchange response (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: US EIA-930. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.","url":"https://api.truthbear.co/gauge/grid-reliability-region","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["entity"],"properties":{"entity":{"type":"string","examples":["caiso","ercot","miso","pjm","spp","nyiso"],"description":"required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]","x-accepted-values":{"all":"https://api.truthbear.co/schemas/gauge-grid-reliability-region.input.json","shown":6,"total":18}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"legs":{"stress":{"band":"normal","source_ref":"https://www.eia.gov/electricity/gridmonitor/","record_hash":"sha256:1c58e72e03cd85f55f02a4ca1c6920d208251f8e2c25dca76dcbf79c708f124a"},"forecast_stress":{"band":"peak-risk","source_ref":"https://www.eia.gov/electricity/gridmonitor/","record_hash":"sha256:26b75e9c7387b90934930302b8c6a49a5cd39bc83c39e617520e37f5f39e3dd9"},"realized_strain":{"band":"confirmed-slack","source_ref":"https://www.eia.gov/electricity/gridmonitor/","record_hash":"sha256:2b105512482c421d65e6eecc9cf0e0c780d40b0d021bf5735d0f41baed364832"}},"name":"California ISO","grade":"screening-level, not decision-grade","scope":{"full":"https://api.truthbear.co/scope/v1","verifiability":"unknown","monitoring_not_forecast":true,"intelligence_not_command":true},"entity":"caiso","nature":"This API supplies data organisation and trend description only. It is not a recommendation to act; the decision is yours. Purely descriptive - no judgement, no prediction. Official source plus record_hash; verify with the free /gauge/verify.","provenance":{"freshness":"fresh","age_hours_now":1,"freshness_basis":"cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BaCl6KZgMxn-CBaEObS8i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a 3-leg sequential reliability signal for a US power grid balancing authority, combining day-ahead demand forecast, current demand vs. capacity, and realized reserve/interchange response.","exampleAgentPrompt":"Can you check the current grid reliability status for ERCOT — specifically whether the day-ahead demand forecast is near peak, how tight capacity is right now, and whether reserves have responded — and tell me how many legs of the reliability chain are confirmed?","exampleUseCases":[{"title":"ERCOT grid stress monitoring","prompt":"Pull the grid reliability gauge for ERCOT right now and tell me how many legs of the chain are lit — I want to know if day-ahead demand is approaching peak and whether reserves are holding."},{"title":"Energy trader situational awareness","prompt":"What's the current 3-leg grid reliability signal for us-ercot? I need to know if we're seeing demand tightness against capacity and what the realized reserve response looks like."},{"title":"Automated grid alert pipeline","prompt":"Check the grid reliability chain for ERCOT and report the confidence score — how many legs are active — so I can decide whether to trigger an alert for high grid stress conditions."}],"resultDescription":"A structured 3-leg sequential signal: Leg 1 indicates whether the EIA-930 day-ahead demand forecast is approaching a recent peak with about one day of lead time; Leg 2 shows current demand against capacity tightness; Leg 3 confirms realized reserve and interchange response. The overall confidence score reflects how many legs are lit in order. Returns 422 with no_charge if data is unavailable. Descriptive only — not a forecast or advice.","failureModes":["422 no_charge returned when source EIA-930 data is unavailable — no billing occurs","Invalid or unsupported balancing authority entity code returns an error","Partial chain: only some legs may be lit if upstream data is incomplete","Real-time data lag may cause Leg 2 or Leg 3 to be unresolved"],"whenToPreferThis":"Choose this endpoint when you need a structured, multi-confirmation reliability signal for a specific US balancing authority — particularly ERCOT — sourced directly from EIA-930. It is especially useful when you want sequential confidence-gating (not just a single metric) and need to distinguish between forecast stress, current tightness, and confirmed reserve response. Prefer this over generic energy APIs when you need transparency about data leg confidence and want to avoid being billed when data is unavailable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:43:42.101Z","isFirstParty":false}