# NWS US Weather Forecast (Custom Format)

> NWS US Weather Forecast (Custom Format) is a paid API for AI agents from x402-v2-mint-weather-forecast.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns current conditions plus up to 7-day weather forecast for US locations using National Weather Service data, delivered in a custom concierge output format.

## Facts

- Endpoint: POST https://x402-v2-mint-weather-forecast.vercel.app/v1/weather-forecast/fmt/custom?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nws-us-weather-forecast-custom-format-71916c79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_voQQgZhw9AozqUZnXx7uC

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 nws-us-weather-forecast-custom-format-71916c79 -d '<json body>'
```

Example prompt: What's the current weather and 7-day forecast for Austin, Texas — I need the National Weather Service data in the custom concierge format for coordinates 30.27 latitude, -97.74 longitude.

## When to prefer this

Choose this endpoint when you need authoritative National Weather Service forecast data for US locations (including territories) with up to 7 days of forecast detail, and you want a custom concierge output format. Prefer it over the Open-Meteo sibling endpoint when NWS sourcing is required or the user is explicitly in the US. Use the JSON, CSV, or Markdown sibling variants if a different output format is needed. Not suitable for non-US locations.

## Known failure modes

- Coordinates outside US coverage (non-US lat/lon) → 400 outside_us_coverage error, no charge
- NWS api.weather.gov upstream outage or timeout → service unavailable error
- Malformed or missing lat/lon inputs → 400 bad request
- Coordinates in US waters with no NWS grid coverage → lookup failure

## How this service works

[concierge custom] US weather: current + up to 7-day forecast from the National Weather Service (api.weather.gov). US and territories only; non-US lat/lon → 400 outside_us_coverage, not charged. Data only — not advice.

## Output

A structured custom-format response containing current weather conditions (temperature, wind, sky/precipitation state) and up to 7 daily forecast periods sourced from the National Weather Service, covering the requested US or territory location. Non-US coordinates return a 400 error and are not charged.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nws-us-weather-forecast-custom-format-71916c79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-weather-forecast.vercel.app](https://www.zero.xyz/host/x402-v2-mint-weather-forecast.vercel.app/llms.txt)
