# US Weather Forecast (NWS 5-Period)

> US Weather Forecast (NWS 5-Period) is a paid API for AI agents from agent-evidence-api.thx93.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns the next five National Weather Service forecast periods for a given latitude and longitude, including temperature, wind speed, wind direction, and plain-language forecast text.

## Facts

- Endpoint: POST https://agent-evidence-api.thx93.workers.dev/v1/weather/forecast?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-weather-forecast-nws-5-period-3d2ef37a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pAH9zuLfI2himyxp509LX

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-5-period-3d2ef37a -d '<json body>'
```

Example prompt: What's the National Weather Service forecast for the next five periods at latitude 40.7128, longitude -74.0060? I need the temperature, wind, and the plain-language description for each period.

## When to prefer this

Choose this endpoint when you need structured, multi-period weather forecast data (temperature, wind, plain-language description) for a precise US geographic coordinate sourced directly from the National Weather Service. It is ideal for US-only location-based forecasting where NWS authority and plain-language summaries matter. For non-US locations, use a different global weather provider. For active severe weather alerts by state, use the companion NWS alerts endpoint on the same host.

## Known failure modes

- Invalid or out-of-range latitude/longitude returns an error or empty forecast
- Location outside the US continental coverage area (NWS only covers US territories) returns no data
- NWS API upstream outage results in a failed or timeout response
- Malformed request body returns a 400-level error
- Payment not provided or insufficient funds returns a 402 Payment Required error

## How this service works

US weather forecast: the next five National Weather Service forecast periods for a latitude and longitude - temperature, wind speed and direction, and the plain-language forecast.

## Output

An array of up to five forecast period objects from the National Weather Service, each containing the period name (e.g. 'Tonight', 'Monday'), temperature with unit, wind speed, wind direction, and a plain-language short forecast description (e.g. 'Mostly sunny').

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "periods": [
   {
    "name": "Today",
    "windSpeed": "5 to 10 mph",
    "temperature": 68,
    "windDirection": "W",
    "temperatureUnit": "F",
    "detailedForecast": "Sunny."
   }
  ],
  "latitude": 37.7749,
  "longitude": -122.4194
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-weather-forecast-nws-5-period-3d2ef37a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-evidence-api.thx93.workers.dev](https://www.zero.xyz/host/agent-evidence-api.thx93.workers.dev/llms.txt)