# Invoket Daily Weather Forecast (GFS, ~16 days)

> Invoket Daily Weather Forecast (GFS, ~16 days) is a paid API for AI agents from api.invoket.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a day-by-day weather forecast for any location for up to ~16 days, including daily min/max temperature, precipitation, and max wind speed decoded from GFS GRIB data, payable per-call via x402 stablecoin.

## Facts

- Endpoint: GET https://api.invoket.com/weather/forecast/daily
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/invoket-daily-weather-forecast-gfs-16-days-b67f60db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_49lPiJAMu3X_FiaIXLW-g

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 invoket-daily-weather-forecast-gfs-16-days-b67f60db
```

Example prompt: What's the daily weather forecast for Tokyo over the next 16 days — give me the min and max temperature, precipitation, and max wind speed for each day?

## When to prefer this

Use this endpoint when you need a multi-day (up to ~16 days) daily weather forecast with no API key or account setup, and you are comfortable paying $0.01 USDC per call via x402. Ideal for agents that need daily granularity (min/max temp, precipitation, wind) from the GFS model without subscribing to a weather service. Prefer over alternatives when you want city-name-based resolution without pre-geocoding, or when per-call stablecoin payment is the desired billing model.

## Known failure modes

- City name not found in GeoNames gazetteer — ambiguous or misspelled city name returns an error or empty result
- Missing required location parameters (no lat/lon and no city) — returns a 400-level error
- GFS model data temporarily unavailable — may return a 503 or partial data
- x402 payment not settled or insufficient USDC balance — request rejected before processing
- Country ISO code invalid or mismatched — may affect city resolution accuracy

## How this service works

Before your agent plans a multi-day operation — logistics, construction, an event, crop work: a day-by-day forecast for any GPS point or city, with daily minimum and maximum 2 m temperature, total precipitation and peak 10 m wind per UTC calendar day, from today to the end of the NOAA GFS window (~16 days), extendable to 35 days on the NOAA GEFS ensemble mean — those extra days are an average of ~30 members, so their extremes are smoothed: trend, not threshold triggers. Each day names the model that served it and carries a coverage flag.

## Output

A JSON response containing one entry per UTC calendar day from today out to the end of the GFS window (~16 days), each with daily minimum and maximum 2m temperature, total precipitation (reconstructed from GFS accumulation buckets), and maximum 10m wind speed. Partial days at window edges are flagged with coverage.complete=false rather than omitted. If a city name was provided, the resolved coordinates and canonical location name are echoed back in data.location.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "lat",
  "lon",
  "days"
 ],
 "properties": {
  "lat": {
   "type": "string"
  },
  "lon": {
   "type": "string"
  },
  "days": {
   "type": "string",
   "description": "Number of UTC calendar days to return, 1-35, starting today. Defaults to 16 — the deterministic GFS window; ask for more explicitly to reach the GEFS ensemble-mean tail, whose smoothed extremes answer trend questions rather than threshold triggers. Alternative to lat+lon: pass city=<name> (alias location=, optional country= ISO 3166 alpha-2) resolved via the embedded GeoNames gazetteer and echoed back as data.location."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/invoket-daily-weather-forecast-gfs-16-days-b67f60db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.invoket.com](https://www.zero.xyz/host/api.invoket.com/llms.txt)
