# agent402.tools Hourly Weather Forecast

> agent402.tools Hourly Weather Forecast is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns a 48-hour (up to 168-hour) hourly weather forecast for any global location, including temperature, precipitation probability and amount, wind, cloud cover, and humidity via Open-Meteo.

## Facts

- Endpoint: GET https://agent402.tools/api/weather-hourly
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-hourly-weather-forecast-059ae096
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zAKk1Zrb38Q9nUK8H-OBi

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 agent402-tools-hourly-weather-forecast-059ae096
```

Example prompt: What's the hour-by-hour weather forecast for the next 48 hours at latitude -33.87, longitude 151.21 — give me temperature in Celsius, precipitation probability, wind, and cloud cover?

## When to prefer this

Use this endpoint when you need granular hour-by-hour weather data (temperature, precipitation, wind, cloud cover, humidity) for any global coordinate over a 48–168 hour window, especially when no API key is available or when Open-Meteo's free-tier data quality is acceptable. Prefer this over daily-summary endpoints when precise hourly timing of precipitation or wind events matters.

## Known failure modes

- Missing lat or lon parameters returns a 400 error
- Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns a validation error
- hours parameter outside 1-168 range may return an error or be clamped
- Invalid temperature unit string returns an error
- Payment not provided or insufficient USDC returns a 402 Payment Required response
- Open-Meteo upstream outage may cause 503 or timeout

## How this service works

48-hour hourly weather forecast for any location: temperature, precipitation probability and amount, wind, cloud cover, humidity. Open-Meteo, no key, global. ?lat=-33.87&lon=151.21.

## Output

An array of hourly forecast entries for the requested location covering up to 168 hours, each including temperature (Celsius or Fahrenheit), precipitation probability (%), precipitation amount (mm), wind speed, cloud cover (%), and relative humidity (%). Powered by Open-Meteo with global coverage, no API key required.

## 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",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude, -90 to 90"
      },
      "lon": {
       "type": "number",
       "description": "Longitude, -180 to 180"
      },
      "hours": {
       "type": "number",
       "description": "Forecast hours, 1-168 (default 48)"
      },
      "units": {
       "type": "string",
       "description": "Temperature unit: celsius (default) or fahrenheit"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "lat",
      "lon",
      "hours",
      "source"
     ],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "hours": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "source": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": -33.8688,
  "lon": 151.2093,
  "hours": [
   {
    "time": "2026-06-23T14:00",
    "unit": "°C",
    "humidity": 62,
    "windUnit": "km/h",
    "condition": "Mainly clear",
    "windSpeed": 14.8,
    "cloudCover": 25,
    "temperature": 18.2,
    "weatherCode": 1,
    "precipitation": 0,
    "windDirection": 195,
    "precipProbability": 10
   }
  ],
  "source": "api.open-meteo.com (CC BY 4.0)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-hourly-weather-forecast-059ae096/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)