# SkyFeed Weather Forecast

> SkyFeed Weather Forecast is a paid API for AI agents from skyfeed.imac2014ville.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Returns a 1–48 hour hourly weather forecast for any global location by city name or lat/lon coordinates, including temperature, precipitation, wind, humidity, and pressure.

## Facts

- Endpoint: GET https://skyfeed.imac2014ville.workers.dev/forecast?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/skyfeed-weather-forecast-762072d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fy1RAqnIuOqrGRNZxKJzV

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 skyfeed-weather-forecast-762072d2
```

Example prompt: What's the weather forecast for the next 24 hours in London — give me temperature range, precipitation, and wind?

## When to prefer this

Use this endpoint when you need a structured hourly forecast for any global location without managing API keys, paying only per call via USDC on Base. It is ideal for AI agents that need weather data on demand without subscription overhead. Prefer it over raw weather APIs when you need a clean, pre-summarized JSON response with both a narrative summary and full hourly detail from MET Norway's high-quality global model.

## Known failure modes

- Missing both 'city' and 'lat'/'lon' query parameters — returns validation error
- City name not in the ~260 built-in city list and no lat/lon provided — returns unresolved location error
- 'hours' parameter outside 1–48 range — may return error or be clamped
- Upstream MET Norway API unavailable — returns 5xx or timeout
- Invalid latitude/longitude values outside valid range — returns validation error
- Payment not completed via x402 — returns HTTP 402 Payment Required

## How this service works

Pay-per-call weather forecasts (global), current conditions, US severe-weather alerts, earthquakes, public holidays and a bundled travel check for AI agents. No API key: pay USDC on Base per call via x402.

## Output

A JSON object with an 'ok' flag, the number of forecast hours, data source attribution, a natural-language summary (min/max temp, total precipitation, max wind over the period), an array of hourly forecast objects (time, tempC, symbol, windMs, windKmh, cloudPct, precipMm, humidityPct, pressureHpa, windFromDeg, stepHours), and a location block confirming resolved lat/lon, city, and country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "anyOf": [
      {
       "required": [
        "lat",
        "lon"
       ]
      },
      {
       "required": [
        "city"
       ]
      }
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude in decimal degrees, -90 to 90 (use with lon)"
      },
      "lon": {
       "type": "number",
       "description": "Longitude in decimal degrees, -180 to 180 (use with lat)"
      },
      "city": {
       "type": "string",
       "description": "Major world city name, e.g. Tokyo, London, New York (about 260 built in; otherwise pass lat and lon)"
      },
      "hours": {
       "type": "number",
       "description": "Hours ahead, 1-48 (default 24)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "hours": 24,
  "source": "MET Norway Locationforecast (CC BY 4.0)",
  "summary": {
   "text": "14.2 to 21.1 C, 0.4 mm precipitation, peak wind 6.1 m/s over the next 24 h",
   "maxTempC": 21.1,
   "minTempC": 14.2,
   "wetHours": 1,
   "maxWindMs": 6.1,
   "totalPrecipMm": 0.4
  },
  "forecast": [
   {
    "time": "2026-10-09T16:00:00Z",
    "tempC": 20.6,
    "symbol": "clearsky_day",
    "windMs": 3.4,
    "windKmh": 12.2,
    "cloudPct": 0,
    "precipMm": 0,
    "stepHours": 1,
    "humidityPct": 41.2,
    "pressureHpa": 1020.6,
    "windFromDeg": 262.7
   }
  ],
  "location": {
   "lat": 40.713,
   "lon": -74.006,
   "city": "New York",
   "country": "US"
  }
 }
}
```

## More

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