{"uid":"cap_hQfmhaUSBZle_lI72Bzj2","slug":"nws-spc-severe-convection-region-hazard-gauge-2a8b9268","name":"NWS/SPC Severe Convection Region Hazard Gauge","description":"[3-LEG] Severe convection and hail chain, one convective region (?entity=tornado-alley-core): leading SPC Day-1 outlook with CAPE, CIN and shear - hours of lead -> current current storm reports -> realized realized hail and wind damage reports (confirmation gate). A sequential chain, not one reading - confidence = how many legs are lit, in order. Sources: NOAA SPC. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed.","url":"https://aeml-x402.zeabur.app/gauge/severe-convection-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":["tornado-alley-core","tx-panhandle-hail","central-kansas","high-plains-hail-alley","front-range-co","northern-plains"],"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-severe-convection-region.input.json","shown":6,"total":16}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json"},"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_UdxtURzCR_m3JMaobI2kr","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 real-time three-leg causal chain for a US severe convective storm region: forecast risk environment (SPC outlook + CAPE/CIN + wind shear), current NWS severe/tornado warnings, and SPC-verified storm reports (hail size, wind gusts, tornado counts) with crop/aviation/utility exposure.","exampleAgentPrompt":"Pull the full severe convection hazard picture for tornado-alley-core — I need the SPC day-1 outlook, current CAPE/wind shear, any active NWS severe or tornado warnings, and what hail sizes and tornado counts have actually been reported so far today, plus how that maps to crop and aviation exposure.","exampleUseCases":[{"title":"Parametric hail insurance trigger check","prompt":"I need the current severe convection hazard package for tornado-alley-core — specifically the SPC-verified hail sizes reported today, whether any PDS watches are active, and the crop exposure layer, so I can evaluate whether our parametric hail policy trigger threshold has been hit."},{"title":"Agricultural logistics re-routing decision","prompt":"What's the live severe storm picture for the southern-plains region right now? Give me the SPC outlook, active tornado and severe thunderstorm warnings, and any wind gust reports so I can decide whether to hold our grain transport trucks."},{"title":"Aviation dispatcher severe weather briefing","prompt":"Get me the NWS and SPC severe convection status for midwest-corridor — I want the CAPE/CIN environment, any active severe weather warnings, and reported wind gust and tornado counts from today's storm reports so our dispatchers can assess route risk."}],"resultDescription":"A structured JSON object containing: (1) forecast risk environment leg with SPC day-1 outlook, CAPE, CIN, and wind shear values; (2) current warnings leg with active NWS severe/tornado warnings and PDS watches; (3) storm reports leg with SPC-verified hail sizes, wind gusts, and tornado counts plus crop/aviation/utility exposure scores; (4) a cross-line narrative describing causal relationships; (5) provenance metadata including data age, freshness status, and traceable source citations; (6) a grade disclosure indicating screening-level data not suitable for emergency decisions.","failureModes":["Entity key not recognized — returns error if ?entity= value does not match a supported convective region","NWS/SPC source lag — data_age_hours may be elevated during source outages, flagged as stale in freshness field","No active warnings or reports — legs return null or empty arrays when no severe weather is occurring in the region","Payment not received — x402 micropayment required; unpaid requests return 402 status","Region out of scope — only US convective regions supported; non-US entities return error"],"whenToPreferThis":"Choose this endpoint when you need a single-call, officially-sourced, cross-validated severe convective storm hazard picture for a specific US region — combining upstream forecast environment, live warnings, and downstream storm verification. Preferred over raw NWS/SPC APIs when you need the three-leg causal chain pre-assembled with provenance and freshness metadata, and when the use case is property/crop/parametric insurance screening, agricultural logistics, aviation dispatch, or utility risk monitoring. Not appropriate for emergency shelter-in-place decisions or life-safety guidance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:54:04.282Z","isFirstParty":false}