# US Weather Forecast API (National Weather Service)

> US Weather Forecast API (National Weather Service) is a paid API for AI agents from gateway.stride20k.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns the official NWS weather forecast for any US latitude/longitude — up to 4 periods (~48 hours, day/night) including temperature, wind, and forecast text

## Facts

- Endpoint: GET https://gateway.stride20k.com/weather/us?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-weather-forecast-api-national-weather-service-9bf1b550
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CiEH17Gf3c6iRapUAu9i8

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-api-national-weather-service-9bf1b550
```

Example prompt: What's the official weather forecast for the next two days at coordinates 37.7749° N, 122.4194° W — I need temperature, wind, and a description for each day/night period.

## When to prefer this

Use this endpoint when you need the official US government (NWS/NOAA) weather forecast for a specific US latitude/longitude — ideal for logistics, travel, and event-planning agents that need authoritative day/night forecasts for the next ~48 hours. Prefer this over commercial weather APIs when public-domain, attribution-free government data is acceptable and coverage is limited to the continental US, Alaska, Hawaii, and US territories with NWS grid coverage.

## Known failure modes

- Coordinates outside US NWS coverage (e.g. international locations) return a 404 error
- Invalid lat/lon format or missing required query parameters returns a 400 error
- NWS upstream outage may cause delayed or failed responses
- Coordinates in US waters or territories without NWS grid coverage may return 404
- Cached responses (up to 10 minutes) may not reflect the very latest NWS update

## How this service works

US weather forecast API: official National Weather Service forecast for any US lat/lon — next four periods (~48 hours, day/night): temperature, wind, short and detailed forecast text, plus resolved place name. UNITED STATES COVERAGE ONLY; points outside NWS coverage return an unpaid 404. Public-domain government data. Use for logistics, travel, and event-planning agents. Cached up to 10 minutes; nearby coordinates (within ~0.1°/11km) may share a cached forecast.

## Output

A JSON object with up to 4 forecast periods (each with name like 'Tonight', temperature in °F, wind speed/direction, short forecast summary, and detailed forecast text), the resolved city/state location name, the NWS update timestamp, and cache metadata indicating whether the response was served from cache and when it was fetched.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "periods": [
    {
     "name": "Tonight",
     "isDaytime": false,
     "startTime": "2026-07-03T21:00:00-05:00",
     "windSpeed": "5 to 10 mph",
     "temperature": 71,
     "shortForecast": "Showers And Thunderstorms",
     "windDirection": "E",
     "temperatureUnit": "F",
     "detailedForecast": "Showers and thunderstorms before 4am."
    }
   ],
   "updated": "2026-07-03T18:00:00+00:00",
   "location": "Linn, KS"
  },
  "meta": {
   "cached": false,
   "source": "NWS",
   "fetchedAt": "2026-07-04T00:00:00.000Z",
   "attribution": null
  },
  "endpoint": "/weather/us"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-weather-forecast-api-national-weather-service-9bf1b550/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.stride20k.com](https://www.zero.xyz/host/gateway.stride20k.com/llms.txt)