{"uid":"cap_FGQ2WSu-C2IMoH6bSfhI4","slug":"truthbear-severe-convection-hail-chain-9e632508","name":"TruthBear Severe Convection & Hail Chain","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 hail and wind damage reports (confirmation gate). A 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. $0.25 per call.","url":"https://api.truthbear.co/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":{"legs":{"forecast_risk_env":{"band":"slight","source_ref":"https://www.spc.noaa.gov/products/outlook/","record_hash":"sha256:bc0a48f3666ce6a62c3f9585c493efc1a25cbd18a28e5cd62c8f6ab905d7a075"},"active_warning_state":{"band":"none","source_ref":"https://api.weather.gov/","record_hash":"sha256:1df656530e8dd69fe59f82579c2e5cf4585066015777a6e8a2975a6eb54c8ece"},"realized_severe_reports":{"band":"none","source_ref":"https://www.spc.noaa.gov/climo/reports/","record_hash":"sha256:7285e2d5fafd2a6078ef1781a661d704627bbcaadaafeb3c3ff735b777da58a3"}},"name":"Tornado Alley Core (OK/S-KS)","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":"tornado-alley-core","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":0,"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_kjuGxSII7L5r-XsfUlTug","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 for a named convective region: SPC Day-1 outlook with CAPE/CIN/shear, current storm reports, and realized hail/wind damage confirmations.","exampleAgentPrompt":"Pull the full severe convection and hail chain for tornado-alley-core — I want to see the SPC Day-1 outlook with CAPE and shear, any current storm reports, and whether there's confirmed hail or wind damage yet.","exampleUseCases":[{"title":"Pre-storm hail risk check for insurers","prompt":"What's the current severe convection chain status for the Texas Panhandle hail corridor? I need the SPC outlook, active storm reports, and any confirmed hail damage coming through so far today."},{"title":"Operational farm field decision support","prompt":"Check the high-plains-hail-alley convection chain for me — are there any active storm reports and has hail damage been confirmed on the ground yet today?"},{"title":"Real-time severe weather monitoring dashboard","prompt":"Get me the 3-leg severe weather chain for central-kansas — I want to know if the SPC Day-1 outlook is elevated, whether storm reports are coming in, and if any realized hail or wind damage has been confirmed."}],"resultDescription":"A JSON object representing three sequentially chained legs: (1) leading SPC Day-1 convective outlook including CAPE, CIN, and shear values; (2) current storm reports for the specified region; (3) realized hail and wind damage reports as confirmation. A confidence score reflects how many legs are currently 'lit' (1–3). Returns HTTP 422 with no_charge code if data is unavailable for the requested region, and the call is not billed.","failureModes":["422 no_charge: no data available for the specified entity — call is not billed","Invalid entity ID returns error — use GET /gauge/catalog?signal_id=<signal_id> to list valid entities","Payment failure via x402 prevents call completion","Partial data: some legs may return null if SPC or storm report sources are unavailable"],"whenToPreferThis":"Choose this endpoint when you need a sequential, multi-leg confirmation chain for severe convective weather in a specific US region — not just a raw forecast, but a pipeline from leading SPC outlook signals through current storm activity to realized hail and wind damage confirmation. Preferred over generic weather APIs when you need NOAA SPC-sourced CAPE/CIN/shear data chained with ground-truth damage confirmation in one call. Best when operating in one of the 16 predefined monitored convective regions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T04:06:53.968Z","isFirstParty":false}