# Delx NWS Weather Forecast

> Delx NWS Weather Forecast is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns a normalized multi-period National Weather Service (NOAA/NWS) weather forecast for a given US latitude/longitude coordinate

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/weather-forecast
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-nws-weather-forecast-89773f70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c2ib7edStUnxGHcGfq-VJ

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 delx-nws-weather-forecast-89773f70 -d '<json body>'
```

Example prompt: What's the official NWS weather forecast for the next 5 periods at latitude 38.9072, longitude -77.0369?

## When to prefer this

Choose this endpoint when you need official US government (NOAA/NWS) weather forecast data for a specific US latitude/longitude, especially when accuracy and attribution matter. Prefer this over general weather APIs when you need authoritative NWS data, multi-period structured forecasts, and are guaranteed to be working within US geographic coverage. At $0.001 USDC per call it is cost-effective for per-request lookups.

## Known failure modes

- Coordinates outside the US (including non-US territories not covered by NWS) return an error — NWS only covers US land area
- Invalid latitude/longitude values (out of -90 to 90 / -180 to 180 range) cause a validation error
- NWS upstream API timeout or unavailability may cause timeout errors (max 8 seconds)
- Ocean or offshore coordinates not covered by NWS grid will return a not-found error
- Requesting more than 10 periods returns a validation error

## How this service works

US weather forecast API for agents: return a normalized National Weather Service (NOAA/NWS) multi-period forecast for $0.001 USDC from latitude/longitude only—US coverage, attributed periods, no arbitrary URL proxy and no global weather claim.

## Output

A JSON object containing an array of normalized NWS forecast periods, each with a period name (e.g. 'Tonight', 'Monday'), temperature, wind, short forecast description, and attribution to the National Weather Service. Up to 10 periods returned depending on the 'periods' parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "periods": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  },
  "timeout": {
   "type": "integer",
   "default": 8,
   "maximum": 8,
   "minimum": 2
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "cache": "miss",
   "schema": "delx/weather-forecast/v1",
   "periods": [
    {
     "name": "Today",
     "number": 1,
     "endTime": "2026-08-01T18:00:00-04:00",
     "isDaytime": true,
     "startTime": "2026-08-01T12:00:00-04:00",
     "temperature": 87,
     "shortForecast": "Mostly Sunny",
     "temperatureUnit": "F"
    },
    {
     "name": "Tonight",
     "number": 2,
     "endTime": "2026-08-02T06:00:00-04:00",
     "isDaytime": false,
     "startTime": "2026-08-01T18:00:00-04:00",
     "temperature": 70,
     "shortForecast": "Mostly Clear",
     "temperatureUnit": "F"
    }
   ],
   "coverage": "US",
   "provider": "National Weather Service (NOAA)",
   "attribution": "Forecast data supplied by the National Weather Service; see provider_url for source and coverage.",
   "coordinates": {
    "latitude": 38.9072,
    "longitude": -77.0369
   },
   "forecast_url": "https://api.weather.gov/gridpoints/LWX/96,70/forecast",
   "provider_url": "https://www.weather.gov/",
   "periods_returned": 2,
   "periods_requested": 2
  },
  "tool_name": "get_weather_forecast_nws"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-nws-weather-forecast-89773f70/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)