# AgentUtility Weather API

> AgentUtility Weather API is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns current weather conditions, hourly forecast, and up to 7-day daily forecast for a given latitude/longitude, powered by Open-Meteo

## Facts

- Endpoint: POST https://x402.agentutility.ai/weather-api
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-weather-api-ece31446
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h5K2gT9sj0I77Z7lboiHR

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 agentutility-weather-api-ece31446 -d '<json body>'
```

Example prompt: What's the current weather and 5-day forecast for San Francisco (37.7749, -122.4194) in imperial units?

## When to prefer this

Choose this endpoint when an AI agent needs structured weather data (current conditions + hourly + daily forecast) for any global coordinate, especially in a micropayment-native (x402/USDC) agentic context. Prefer it over free-tier weather APIs when operating in a USDC-settled agent pipeline or when you need a single endpoint that covers current, hourly, and multi-day forecasts together. The Open-Meteo backend provides reliable global coverage with no API key required beyond the x402 payment.

## Known failure modes

- Invalid or out-of-range latitude/longitude returns an error
- Missing required coordinate parameters results in a 400-level error
- Unsupported unit system value may cause a validation error
- Network or upstream Open-Meteo availability issues may cause 5xx errors
- Forecast day count outside 1-7 range may be rejected or clamped

## How this service works

Weather API returning current conditions, hourly forecast, and a 1-7 day daily forecast for any latitude/longitude. Metric or imperial units. Open-Meteo backend. Use it as a current weather API or forecast API.

## Output

A JSON response containing current weather conditions (temperature, wind speed, precipitation, humidity, etc.), an hourly forecast array for the coming hours, and a daily forecast for up to 7 days — all in the requested unit system (metric or imperial). Powered by the Open-Meteo backend.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "daily": [
   {
    "date": "2026-05-06",
    "sunset": "2026-05-06T20:11",
    "sunrise": "2026-05-06T06:08",
    "uv_index_max": 7.5,
    "weather_code": 3,
    "temperature_max": 67.3,
    "temperature_min": 53.1,
    "precipitation_mm": 0,
    "precipitation_probability_max": 5
   }
  ],
  "units": "imperial",
  "source": "https://open-meteo.com",
  "current": {
   "time": "2026-05-06T13:00",
   "is_day": true,
   "wind_speed": 8.2,
   "temperature": 62.1,
   "humidity_pct": 78,
   "weather_code": 3,
   "precipitation": 0,
   "wind_direction_deg": 270,
   "apparent_temperature": 60.4
  },
  "location": {
   "lat": 37.7749,
   "lon": -122.4194,
   "timezone": "America/Los_Angeles",
   "elevation_m": 18
  }
 }
}
```

## More

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