# Lumen Weather Forecast

> Lumen Weather Forecast is a paid API for AI agents from lumenworks-x402-decoder.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Returns current weather conditions plus up to 16-day daily forecast for any place name or lat/lon coordinates, powered by Open-Meteo

## Facts

- Endpoint: POST https://lumenworks-x402-decoder.onrender.com/v1/weather/forecast?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumen-weather-forecast-5abec899
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YPKqWLi4tnN0J2MwquUST

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 lumen-weather-forecast-5abec899 -d '<json body>'
```

Example prompt: What's the weather like in Berlin right now, and can you give me a 7-day forecast with daily highs, lows, rain chances, and UV index?

## When to prefer this

Choose this endpoint when you need weather data (current or forecast) for any global location by place name or coordinates, and you want a single call that returns both current conditions and multi-day forecasts in one response. It's particularly good for agents that need to resolve a human-readable city name to weather data without separate geocoding steps. Prefer this over raw Open-Meteo direct calls when operating in an x402 micropayment context or when you need a consistent, pre-parsed JSON schema.

## Known failure modes

- Unknown or ambiguous place name — geocoding fails, returning an error or empty result
- Invalid latitude/longitude values outside valid ranges (-90 to 90 lat, -180 to 180 lon)
- Forecast day count exceeds 16-day maximum — clamped or error returned
- Open-Meteo upstream unavailability causing 503 or timeout
- Service cold-start delay on Render.com free tier causing initial request timeout
- Payment not processed (x402 protocol) causing 402 Payment Required before data is returned

## How this service works

Weather for any place name or lat/lon (Open-Meteo): current conditions plus up to 16-day daily forecast (temp min/max, precipitation and probability, wind, UV, sunrise/sunset). {location | latitude+l…

## Output

A JSON object containing: (1) current conditions — temperature, apparent temperature, humidity, wind speed and direction, precipitation, weather code, and whether it's daytime; (2) an array of daily forecasts (up to 16 days) with max/min temperature, precipitation sum, precipitation probability, max wind speed, UV index, and sunrise/sunset times; (3) geocoded place info including name, admin region, country, timezone; and (4) a units metadata block describing all measurement units used.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "daily": [
   {
    "date": "2026-10-10",
    "tMax": 16.7,
    "tMin": 11.1,
    "uvMax": 3.1,
    "sunset": "2026-10-10T18:23",
    "sunrise": "2026-10-10T07:22",
    "windMax": 17.4,
    "precipSum": 1.5,
    "weatherCode": 80,
    "precipProbMax": 85
   },
   {
    "date": "2026-10-11",
    "tMax": 12.7,
    "tMin": 8.4,
    "uvMax": 1.65,
    "sunset": "2026-10-11T18:20",
    "sunrise": "2026-10-11T07:24",
    "windMax": 16.8,
    "precipSum": 0.9,
    "weatherCode": 80,
    "precipProbMax": 83
   }
  ],
  "place": {
   "name": "Berlin",
   "admin1": "State of Berlin",
   "country": "Germany",
   "geocoder": "open-meteo",
   "timezone": "Europe/Berlin"
  },
  "units": {
   "time": "iso8601",
   "is_day": "",
   "interval": "seconds",
   "weather_code": "wmo code",
   "precipitation": "mm",
   "temperature_2m": "°C",
   "wind_speed_10m": "km/h",
   "wind_direction_10m": "°",
   "apparent_temperature": "°C",
   "relative_humidity_2m": "%"
  },
  "source": "Open-Meteo (CC BY 4.0)",
  "current": {
   "time": "2026-10-10T14:45",
   "is_day": 1,
   "interval": 900,
   "weather_code": 2,
   "precipitation": 0,
   "temperature_2m": 16.5,
   "wind_speed_10m": 14.8,
   "wind_direction_10m": 257,
   "apparent_temperature": 13.4,
   "relative_humidity_2m": 51
  },
  "latitude": 52.512604,
  "timezone": "Europe/Berlin",
  "longitude": 13.419517
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumen-weather-forecast-5abec899/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lumenworks-x402-decoder.onrender.com](https://www.zero.xyz/host/lumenworks-x402-decoder.onrender.com/llms.txt)