# Datakoot Weather Forecast (NWS/NOAA)

> Datakoot Weather Forecast (NWS/NOAA) is a paid API for AI agents from x402.datakoot.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns daily or hourly weather forecasts for a US location using National Weather Service data, charged per-call via x402 USDC micropayment.

## Facts

- Endpoint: POST https://x402.datakoot.com/api/weather_forecast?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datakoot-weather-forecast-nws-noaa-d56d3ea1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r2kyHKE6LVldgKM1ktIEF

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 datakoot-weather-forecast-nws-noaa-d56d3ea1 -d '<json body>'
```

Example prompt: What's the weather forecast for the next few days at latitude 36.1867, longitude -94.1288? Give me daily periods with temperatures, wind, and precipitation chances.

## When to prefer this

Choose this endpoint when you need authoritative US weather forecasts from NOAA/NWS at a specific lat/lon coordinate, either daily periods or hourly breakdowns, with precipitation probability and wind data. Prefer it over commercial weather APIs when you want public-domain government data, pay-per-use micropayment pricing ($0.002 USDC), and no subscription required. Not suitable for non-US locations.

## Known failure modes

- Coordinates outside the US (NWS only covers US territory) — returns an error or empty response
- Invalid or missing lat/lon values — schema validation error
- NWS API upstream outage — returns a service unavailable error
- Payment failure via x402 — call is not charged and not executed
- Coordinates in a US territory not covered by NWS grid — may return a not-found error

## How this service works

48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) for AI agents. $0.002 USDC per call on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at <server>.datakoot.com/mcp.

## Output

A JSON object containing the forecast type (daily or hourly), data source attribution (NWS/NOAA), location name, timezone, and an array of forecast periods. Each period includes a name (e.g. 'Saturday', 'Overnight'), start time, daytime flag, temperature, wind speed and direction, short summary, detailed narrative description, and precipitation probability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "Latitude in decimal degrees, e.g. 36.1867. US coverage only (National Weather Service)."
  },
  "lon": {
   "type": "number",
   "description": "Longitude in decimal degrees, negative in the western hemisphere, e.g. -94.1288."
  },
  "hourly": {
   "type": "boolean",
   "default": false,
   "description": "If true, return the hourly forecast instead of daily periods."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "daily",
  "source": "NWS / NOAA (public domain)",
  "periods": [
   {
    "name": "Overnight",
    "wind": "7 mph N",
    "short": "Mostly Cloudy",
    "start": "2026-10-03T05:00:00-04:00",
    "detailed": "Mostly cloudy, with a low around 55. North wind around 7 mph.",
    "is_daytime": false,
    "precip_prob": "0%",
    "temperature": "55°F"
   },
   {
    "name": "Saturday",
    "wind": "7 mph NE",
    "short": "Sunny",
    "start": "2026-10-03T06:00:00-04:00",
    "detailed": "Sunny, with a high near 71. Northeast wind around 7 mph.",
    "is_daytime": true,
    "precip_prob": "0%",
    "temperature": "71°F"
   }
  ],
  "location": "Harrisburg, PA",
  "timezone": "America/New_York"
 }
}
```

## More

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