# Maxwell International Hourly Weather Forecast API

> Maxwell International Hourly Weather Forecast API is a paid API for AI agents from api.maxwellinternational.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-30).

Returns hourly weather forecast data including temperature, wind speed, wind direction, and short forecast description for a given location

## Facts

- Endpoint: GET https://api.maxwellinternational.ai/v1/weather/forecast-hourly?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/maxwell-international-hourly-weather-forecast-api-a2c9eaa0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lqNhBn2AmzVVrCQ-YiwmN

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 maxwell-international-hourly-weather-forecast-api-a2c9eaa0
```

Example prompt: What's the hour-by-hour weather forecast for Denver, Colorado right now — give me temperature and wind conditions for each hour?

## When to prefer this

Choose this endpoint when you need official US government (NOAA/NWS) hourly weather forecast data for a specific US location, especially when you require granular hour-by-hour breakdowns of temperature and wind rather than daily summaries. Prefer this over third-party weather APIs when NWS-authoritative data is required, and over daily forecast endpoints when hourly resolution is needed for time-sensitive planning.

## Known failure modes

- Location outside US NWS coverage area returns no forecast data
- Invalid or missing lat/lon query parameters result in an error
- NWS upstream API outage causes 5xx or empty response
- Cache miss may increase response latency slightly
- Coordinates that don't resolve to a valid NWS grid point return an error

## How this service works

NWS hourly forecast (about 7 days) for a US point or grid. From the NWS (US and territories), cached and refreshed about every 3 hours; a location not yet cached answers 404, is not charged, and is queued.

## Output

Returns a JSON object with an array of hourly forecast periods, each containing start/end time, temperature in Fahrenheit and Celsius, wind speed, wind direction, isDaytime flag, short forecast string (e.g. 'Partly Cloudy'), and metadata including WFO office code, grid coordinates, state, country, cache status, and generation timestamp.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sku": "weather.forecast-hourly",
  "wfo": "BOU",
  "cache": "hit",
  "gridX": 63,
  "gridY": 62,
  "state": "Colorado",
  "country": "United States",
  "periods": [
   {
    "name": null,
    "endTime": "2026-09-25T22:00:00-06:00",
    "isDaytime": false,
    "startTime": "2026-09-25T21:00:00-06:00",
    "windSpeed": "5 mph",
    "temperature": 64,
    "temperatureC": 17.8,
    "shortForecast": "Partly Cloudy",
    "windDirection": "SSW",
    "temperatureUnit": "F",
    "detailedForecast": null
   }
  ],
  "updatedAt": null,
  "generatedAt": "2026-09-26T03:52:20.496Z",
  "sourceClass": "official-api",
  "resolvedFrom": "latlon"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/maxwell-international-hourly-weather-forecast-api-a2c9eaa0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.maxwellinternational.ai](https://www.zero.xyz/host/api.maxwellinternational.ai/llms.txt)