# Tollkit Weather Forecast & Alerts

> Tollkit Weather Forecast & Alerts is a paid API for AI agents from data.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns up to 14 12-hour forecast periods for a given location (lat/lon or US address) via pay-per-call x402 micropayment, no API key required.

## Facts

- Endpoint: POST https://data.tollkit.dev/weather?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/tollkit-weather-forecast-alerts-02c5ff89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oR22tuGuhqI702eC0i992

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 tollkit-weather-forecast-alerts-02c5ff89 -d '<json body>'
```

Example prompt: What's the weather forecast for the next 7 days at 38.98 latitude, -76.49 longitude — give me 14 12-hour periods?

## When to prefer this

Choose this endpoint when you need a no-signup, pay-per-call weather forecast and want to avoid API key management. It is ideal for AI agents that need weather data on demand for US locations, especially when combined with x402 micropayment infrastructure. It suits one-off or low-volume forecast lookups billed per call rather than a subscription.

## Known failure modes

- Invalid or out-of-range lat/lon returns an error (e.g. coordinates outside NWS coverage area)
- Non-US address may not be supported if underlying provider is NOAA/NWS
- Payment failure via x402 results in 402 Payment Required response
- Periods value exceeding 14 or below 1 is rejected by schema validation
- Missing both lat/lon and address returns a validation error

## How this service works

SEC filings and financials, IP lookup, US weather, airport delays, address geocoding and exchange rates. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://chain.tollkit.dev/openapi.json.

## Output

A JSON response containing an array of up to 14 sequential 12-hour forecast periods for the requested location, each likely including temperature, precipitation probability, wind speed/direction, and weather condition descriptions. No API key is required; payment is made in-band via x402 protocol in USDC on Base or Solana.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "Latitude, e.g. 38.98"
  },
  "lon": {
   "type": "number",
   "description": "Longitude, e.g. -76.49"
  },
  "address": {
   "type": "string",
   "maxLength": 200,
   "description": "US street address instead of lat/lon, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\"."
  },
  "periods": {
   "type": "integer",
   "default": 14,
   "maximum": 14,
   "minimum": 1,
   "description": "How many 12-hour periods to return."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "alerts": [],
  "source": "U.S. National Weather Service (api.weather.gov). Not endorsed by NWS.",
  "forecast": [
   {
    "end": "2026-10-04T06:00:00-04:00",
    "name": "Overnight",
    "wind": "7 mph",
    "start": "2026-10-04T03:00:00-04:00",
    "detail": "A chance of rain showers. Cloudy, with a low around 61. Northeast wind around 7 mph. Chance of precipitation is 40%. New rainfall amounts less than a tenth of an inch possible.",
    "summary": "Chance Rain Showers",
    "is_daytime": false,
    "temperature": 61,
    "wind_direction": "NE",
    "temperature_unit": "F",
    "precipitation_chance": 35
   },
   {
    "end": "2026-10-04T18:00:00-04:00",
    "name": "Sunday",
    "wind": "9 mph",
    "start": "2026-10-04T06:00:00-04:00",
    "detail": "Rain showers likely before 5pm. Cloudy, with a high near 67. Northeast wind around 9 mph. Chance of precipitation is 70%. New rainfall amounts less than a tenth of an inch possible.",
    "summary": "Rain Showers Likely",
    "is_daytime": true,
    "temperature": 67,
    "wind_direction": "NE",
    "temperature_unit": "F",
    "precipitation_chance": 68
   }
  ],
  "location": {
   "lat": 38.9784,
   "lon": -76.4922,
   "city": "Annapolis",
   "state": "MD",
   "office": "LWX",
   "time_zone": "America/New_York"
  },
  "forecast_updated": "2026-10-04T06:22:51+00:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollkit-weather-forecast-alerts-02c5ff89/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.tollkit.dev](https://www.zero.xyz/host/data.tollkit.dev/llms.txt)