{"uid":"cap_-6dFuQ_E9wR8WaYa_WYtG","slug":"foundry-nws-weather-alert-window-composite-fe4ff8d3","name":"Foundry NWS Weather Alert Window Composite","description":"Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.","url":"https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/nws-weather-alert-window-composite","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"latitude":{"type":"number","maximum":90,"minimum":-90},"longitude":{"type":"number","maximum":180,"minimum":-180},"max_wind_kph":{"type":"number","maximum":400,"minimum":0},"duration_hours":{"type":"integer","default":12,"maximum":24,"minimum":1},"max_temperature_c":{"type":"number","maximum":60,"minimum":-100},"min_temperature_c":{"type":"number","maximum":60,"minimum":-100},"start_hours_from_now":{"type":"integer","default":0,"maximum":120,"minimum":0},"max_precipitation_probability":{"type":"number","maximum":100,"minimum":0}}},"responseSchema":{"type":"json","example":{"route":"nws-weather-alert-window-composite","result":{"sources":[{"url":"https://api.weather.gov/gridpoints/TOP/31,80/forecast/hourly","kind":"HOURLY_FORECAST","updated_at":null,"retrieved_at":"2026-09-07T00:00:00Z","cache_age_seconds":0},{"url":"https://api.weather.gov/alerts?active=true&point=39.7456%2C-97.0892&limit=100","kind":"CURRENT_POINT_ALERTS","updated_at":null,"retrieved_at":"2026-09-07T00:00:00Z","cache_age_seconds":0}],"location":{"latitude":39.7456,"longitude":-97.0892},"terms_url":"https://www.weather.gov/disclaimer","thresholds":{"max_wind_kph":25,"max_temperature_c":30,"min_temperature_c":5,"max_precipitation_probability":30},"alert_scope":"CURRENT_ACTIVE_ONLY","attribution":"NOAA / National Weather Service; normalized by Foundry; no endorsement","limitations":["Synthetic example only. No alerts or matching weather does not prove safe conditions."],"current_alerts":[],"joined_windows":[{"end":"2026-09-07T12:00:00Z","start":"2026-09-07T00:00:00Z","weather_status":"UNKNOWN","overlapping_alert_ids":[]}],"weather_periods":[],"alerts_truncated":false,"requested_window":{"end":"2026-09-07T12:00:00Z","start":"2026-09-07T00:00:00Z"},"timing_unknown_alert_ids":[],"forecast_coverage_complete":false},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S7Aho8UZPBJPRwT0nspoK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns NWS hourly forecast periods and active alerts for a US location within a specified future time window, filtered by user-defined weather thresholds (wind, temperature, precipitation).","exampleAgentPrompt":"Check the NWS weather alert window for latitude 39.7456, longitude -97.0892 over the next 12 hours starting now, and flag any periods where wind exceeds 25 kph, temperature goes above 30°C or below 5°C, or precipitation probability is over 30%.","exampleUseCases":[{"title":"Outdoor event safety check","prompt":"I'm planning an outdoor concert at 39.7456° N, 97.0892° W this afternoon — can you pull the NWS forecast and alerts for the next 8 hours and tell me if wind will stay under 40 kph, temps between 10°C and 35°C, and rain chance stays below 50%?"},{"title":"Drone flight window finder","prompt":"I need a safe window to fly my drone near latitude 37.33, longitude -122.03 in the next 6 hours starting 2 hours from now — check NWS alerts and forecast for that window and flag anything where wind goes above 20 kph or precipitation probability exceeds 20%."},{"title":"Cold-weather threshold alert","prompt":"Can you check the NWS weather alerts and hourly forecast for the next 24 hours at lat 44.98, lon -93.27, and tell me if temperatures are expected to drop below -10°C or if there are any active winter weather alerts?"}],"resultDescription":"A JSON object containing: the joined forecast windows with weather status and overlapping NWS alert IDs; the list of current active NWS alerts; individual hourly forecast periods; applied threshold values; the requested time window boundaries; source URLs with retrieval timestamps and cache ages; attribution and terms URL; and flags for truncation and forecast coverage completeness.","failureModes":["Coordinates outside US NWS coverage area (e.g. non-US lat/lon) may return no forecast periods or empty alerts","NWS upstream API unavailability may cause partial or failed responses","duration_hours + start_hours_from_now exceeding NWS forecast horizon returns incomplete coverage (forecast_coverage_complete: false)","Invalid latitude/longitude values (out of -90/90 or -180/180 range) rejected by schema validation","No alerts does not guarantee safe conditions — limitations array explicitly notes this"],"whenToPreferThis":"Choose this endpoint when you need a composite view combining NWS active alerts AND hourly forecast data for a US coordinate, filtered by specific numeric thresholds, with explicit source provenance and JSON contracts. Prefer it over raw NWS API calls when you need threshold-based window detection (safe/unsafe periods) in a single pay-per-request call with normalized output. Not suitable for non-US locations or when you need real-time sensor data rather than NWS model forecasts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:28.672Z","isFirstParty":false}