# Tollkit Weather Forecast

> Tollkit Weather Forecast is a paid API for AI agents from chain.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 US location specified by latitude/longitude or street address, paid per-call via x402 in USDC.

## Facts

- Endpoint: POST https://chain.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-fdf61593
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r4jJVC3un29ONOXziOZhW

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-fdf61593 -d '<json body>'
```

Example prompt: What's the weather forecast for the next 6 periods at 38.98 latitude, -76.49 longitude?

## When to prefer this

Choose this endpoint when you need US weather forecast data and want to pay per-call without creating an account or managing API keys — ideal for agent workflows where credential management is undesirable and crypto micropayments (USDC on Base or Solana via x402) are available. Prefer it over traditional weather APIs when you want frictionless, accountless access.

## Known failure modes

- Location outside the US NWS coverage area returns an error (NWS only covers US territories)
- Invalid or unresolvable street address causes geocoding failure
- Lat/lon or address missing from request body results in a 400-level error
- Payment not provided or insufficient USDC causes x402 payment-required rejection
- Periods value exceeding 14 is rejected by schema validation

## How this service works

Pay-per-call product page extraction. No account, no API key: pay in-band with x402 in USDC on Base or Solana.

## Output

An array of up to 14 12-hour forecast periods for the requested location, each containing weather condition details such as temperature, precipitation probability, wind, and sky conditions, drawn from the US National Weather Service grid.

## 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."
  }
 }
}
```

## More

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