{"uid":"cap__RYvPONAZh_3neHpBdqqQ","slug":"truthbear-grid-region-gauge-8d254d71","name":"TruthBear Grid-Region Gauge","description":"[3-LEG] Power-grid chain, one grid region (?loc=us-ercot): leading demand pressure from heating and cooling degree days -> current renewable availability, solar and wind -> realized energy inflation (CPI energy year-over-year) and gas price (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: EIA, BLS, Open-Meteo. 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-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":["loc"],"properties":{"loc":{"type":"string","examples":["us-ercot","us-caiso","us-pjm","us-miso","us-nyiso","eu-germany"],"description":"required - location id; full list at free /gauge/preview","x-accepted-values":{"all":"https://api.truthbear.co/schemas/gauge-grid-region.input.json","shown":6,"total":12}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"legs":{"demand":{"band":"high","source_ref":"https://open-meteo.com/en/docs (temperature -> HDD/CDD base 18 degC)","record_hash":"sha256:79a8543f6b4562e0e8111abb50fff64a00c167630bd277b717cf56f446f5011a"},"gas_price":{"band":"low","source_ref":"https://fred.stlouisfed.org/series/DHHNGSP","record_hash":"sha256:de4087d873ff105bde0abac04dbc552bc715bcdb42a1c3c82a2eea8d08031727"},"renewable":{"band":"extreme","source_ref":"https://open-meteo.com/en/docs (shortwave_radiation+wind_speed -> CF proxy)","record_hash":"sha256:b740795bd6c729dc1451da0169fb59f638ed98e0c35fecc7c8df7aa1e095df72"},"energy_inflation":{"band":"extreme","source_ref":"https://fred.stlouisfed.org/series/CPIENGSL","record_hash":"sha256:e7eecf1126e1e2b5f5f8dcbb629e1c45051edbd371c4d6e6eada3d9eabdef29d"}},"name":"US - ERCOT (Texas)","grade":"screening-level, not decision-grade","scope":{"full":"https://api.truthbear.co/scope/v1","verifiability":"unknown","monitoring_not_forecast":true,"intelligence_not_command":true},"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.","location":"us-ercot","provenance":{"freshness":"stale","dead_source":true,"age_hours_now":2079,"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_c7dv9F-eXToKdBRERYZWH","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 chain analysis of power-grid stress for a specified grid region, covering demand pressure (HDD/CDD), renewable availability (solar/wind), and realized energy inflation (CPI + gas price confirmation), with a confidence score based on how many legs are data-lit.","exampleAgentPrompt":"Pull the TruthBear grid-region gauge for ERCOT — I want to see demand pressure from heating and cooling degree days, current solar and wind availability, and where realized energy CPI and gas prices stand, plus the confidence score for how many legs are lit.","exampleUseCases":[{"title":"ERCOT grid stress check before trading","prompt":"Check the TruthBear grid gauge for us-ercot and tell me if there's heating or cooling demand pressure, how much solar and wind is available, and what the energy CPI and gas price confirmation looks like — I want to know how stressed the Texas grid is right now."},{"title":"California renewable availability snapshot","prompt":"Run the grid-region gauge for us-caiso and tell me the current renewable availability — solar and wind — along with the demand pressure and energy inflation reading, and let me know how many of the three legs have real data behind them."},{"title":"EU Germany grid energy inflation review","prompt":"Get me the TruthBear gauge reading for eu-germany — I need the heating and cooling degree day pressure, the renewable supply picture, and the realized energy CPI year-over-year with gas price confirmation, and show me the confidence score."}],"resultDescription":"A structured JSON response containing the 3-leg sequential chain: (1) demand pressure derived from heating and cooling degree days, (2) current renewable availability including solar and wind figures, (3) realized energy inflation as CPI energy year-over-year and gas price as a confirmation gate. Also returns a confidence indicator reflecting how many of the three legs have live data. Returns 422 no_charge if no data is available (not billed). Descriptive only — no forecast or investment advice.","failureModes":["422 no_charge: no data available for requested grid region or legs — call is not billed","Invalid loc parameter: unrecognized or unsupported grid region ID","Missing required loc query parameter returns validation error","Upstream data source (EIA, BLS, Open-Meteo) unavailability may reduce confidence score or trigger 422"],"whenToPreferThis":"Use this endpoint when you need a multi-factor, sequential chain assessment of a specific power grid region that combines weather-derived demand signals, real-time renewable availability, and realized macroeconomic energy inflation data in one call. Prefer this over single-signal energy APIs when you need corroborating confirmation across demand, supply, and inflation legs with an explicit confidence score. Best suited for energy market research, grid risk monitoring, or ESG/sustainability analysis by region. Not appropriate when you need raw forecast data, trading signals, or financial advice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:05.746Z","isFirstParty":false}