# OpenWeather Current Weather via Locus x402

> OpenWeather Current Weather via Locus x402 is a paid API for AI agents from openweather.x402.paywithlocus.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-15).

Returns real-time current weather conditions for a given latitude/longitude coordinate, paid via x402 micropayment at $0.006 USDC per call.

## Facts

- Endpoint: POST https://openweather.x402.paywithlocus.com/openweather/current-weather
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openweather-current-weather-via-locus-x402-e33972f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QF5eoK8jVn5jqpaR8Fy11

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 openweather-current-weather-via-locus-x402-e33972f7 -d '<json body>'
```

Example prompt: What's the current weather at latitude 48.8566, longitude 2.3522 — give me the temperature in Celsius and the conditions description in English.

## When to prefer this

Choose this endpoint when you need live, point-in-time weather conditions for a precise geographic coordinate and are comfortable with x402 micropayments. Prefer this over forecast endpoints when you only need the current snapshot, not future predictions. Ideal for agents that already have lat/lon and want a quick, cheap weather lookup without managing an OpenWeatherMap API key directly.

## Known failure modes

- Invalid or out-of-range latitude/longitude returns an error — lat must be -90 to 90, lon must be -180 to 180
- Invalid units string falls back to standard (Kelvin) or may return an error
- Unsupported language code may return descriptions in English fallback
- Payment failure or insufficient USDC balance results in 402 response before data is returned
- Network timeout if OpenWeatherMap upstream is unavailable

## How this service works

Global weather data — current conditions, 5-day forecasts, hourly forecasts, air quality index with pollutants, geocoding, and One Call 3.0 with full weather suite and government alerts.

## Output

A JSON object containing real-time weather data for the requested coordinates, including temperature (in the requested unit system), atmospheric conditions, humidity, wind speed and direction, cloud cover, visibility, sunrise/sunset times, and a human-readable weather description in the requested language. Also includes x402 payment confirmation details (settled USDC, request ID, status URL).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "lang": {
   "type": "string"
  },
  "units": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openweather-current-weather-via-locus-x402-e33972f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from openweather.x402.paywithlocus.com](https://www.zero.xyz/host/openweather.x402.paywithlocus.com/llms.txt)
