# Foundry NWS Weather Alert Window Composite

> Foundry NWS Weather Alert Window Composite is a paid API for AI agents from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

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).

## Facts

- Endpoint: POST https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/nws-weather-alert-window-composite
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-nws-weather-alert-window-composite-fe4ff8d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-6dFuQ_E9wR8WaYa_WYtG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability foundry-nws-weather-alert-window-composite-fe4ff8d3 -d '<json body>'
```

Example prompt: 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%.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-nws-weather-alert-window-composite-fe4ff8d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev](https://www.zero.xyz/host/foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/llms.txt)
