# x402.shizu.me Weather

> x402.shizu.me Weather is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.003/call, not verified (last probed 2026-10-23); live alternatives: NWS Multi-Period Weather Forecast ($0.001) and Otto AI Weather Forecast ($0.002).

Agents call it through Zero, which pays per call: no API key and no wallet of your own. New accounts start with $5.

Live alternatives for the same use case:
- [NWS Multi-Period Weather Forecast](https://www.zero.xyz/c/nws-multi-period-weather-forecast-us-8ecf4277) ($0.001)
- [Otto AI Weather Forecast](https://www.zero.xyz/c/otto-ai-weather-forecast-x402-6019a944) ($0.002)

Returns real-time weather conditions (temperature, humidity, wind speed, weather code) for any lat/lon coordinate via Open-Meteo, with no API key required.

## Facts

- Endpoint: GET https://x402.shizu.me/weather?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-shizu-me-weather-fc98bdfd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2zaPFY16lIOvIDHXNT8G1

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 x402-shizu-me-weather-fc98bdfd
```

Example prompt: What's the current weather at latitude 48.8566, longitude 2.3522? I need the temperature in Celsius, humidity, wind speed, and weather code.

## When to prefer this

Use this endpoint when you need real-time, keyless weather data for any geographic coordinate and only need current conditions (not forecasts). Ideal for lightweight weather lookups in agent workflows where obtaining an API key would be a barrier. Prefer this over full-featured weather APIs when simplicity and no-auth access matter more than extended forecast data or imperial units.

## Known failure modes

- Missing lat or lon parameters returns an error
- Out-of-range coordinate values (e.g. lat > 90) may return an error or unexpected result
- Upstream Open-Meteo API unavailability causes request failure
- Network timeout if Open-Meteo is slow to respond
- Invalid non-numeric values for lat/lon cause a parse error

## How this service works

Weather for any coordinate. Current (default): temperature (C), relative humidity (%), wind speed, weather code — real-time. Historical: add start_date & end_date (YYYY-MM-DD, up to 92 days per call, archive lags ~5 days) for hourly history — backtest weather-sensitive strategies (energy, agriculture, logistics). Inputs: lat, lon, start_date?, end_date?. Keyless (Open-Meteo).

## Output

Returns current weather data for the given coordinate: temperature in degrees Celsius, relative humidity as a percentage, wind speed, and a WMO weather interpretation code indicating conditions (e.g. clear sky, rain, snow).

## Example request

```json
{
 "input": {
  "method": "GET",
  "queryParams": {
   "lat": "48.8566",
   "lon": "2.3522"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "string"
      },
      "lon": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 52.52,
  "lon": 13.4,
  "current": {
   "weather_code": 1,
   "temperature_2m": 17.6,
   "wind_speed_10m": 12.3,
   "relative_humidity_2m": 48
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-shizu-me-weather-fc98bdfd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)
