# US Weather Forecast (NWS)

> US Weather Forecast (NWS) is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Returns the official NOAA/NWS 7-day day/night or hourly weather forecast for a US location by latitude and longitude, including temperature, precipitation chance, wind, and text descriptions.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/weather/us-forecast?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-weather-forecast-nws-5602d200
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kM754cAHeH2kUprFFZuel

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 us-weather-forecast-nws-5602d200
```

Example prompt: What's the NWS 7-day forecast for Miami — I need temperature, precipitation chance, and wind for the next 7 periods? The coordinates are 25.7617 latitude, -80.1918 longitude.

## When to prefer this

Choose this endpoint when you need official US government weather forecasts sourced directly from NOAA/NWS, especially when data authority or accuracy for US locations is important. Prefer this over commercial weather APIs when the user is in the US or its territories and needs structured day/night or hourly forecast data with wind and precipitation. Not suitable for international locations.

## Known failure modes

- Coordinates outside US or territories return an error — international locations are not supported
- Invalid or out-of-range latitude/longitude values cause a 400-level error
- NWS API upstream outage may cause 503 or timeout responses
- Requesting more periods than available data may silently return fewer periods
- Missing required lat or lon query parameters will return a validation error

## How this service works

Official National Weather Service forecast for a US location: 7-day day/night periods or hourly, with temperature, precipitation chance, wind and text forecast. US and territories only.

## Output

Returns an array of forecast periods, each containing: period name (e.g. 'Tonight', 'Monday'), start and end times, temperature and unit, precipitation probability, wind speed and direction, short forecast text, and a detailed forecast description. Supports both 12-hour day/night periods (default) and hourly intervals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude"
      },
      "lon": {
       "type": "number",
       "description": "Longitude"
      },
      "hourly": {
       "type": "boolean",
       "description": "Hourly instead of 12-hour periods"
      },
      "periods": {
       "type": "integer",
       "description": "Periods to return (1-156)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-weather-forecast-nws-5602d200/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)