{"uid":"cap_lqNhBn2AmzVVrCQ-YiwmN","slug":"maxwell-international-hourly-weather-forecast-api-a2c9eaa0","name":"Maxwell International Hourly Weather Forecast API","description":"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.","url":"https://api.maxwellinternational.ai/v1/weather/forecast-hourly?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0pDMf_Wj7K15GTzNWj2eT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly weather forecast data including temperature, wind speed, wind direction, and short forecast description for a given location","exampleAgentPrompt":"What's the hour-by-hour weather forecast for Denver, Colorado right now — give me temperature and wind conditions for each hour?","exampleUseCases":[{"title":"Outdoor event planning by hour","prompt":"I'm organizing an outdoor concert in Boulder, Colorado tomorrow — can you pull the hourly weather forecast so I know when temperatures drop and wind picks up throughout the day?"},{"title":"Hourly wind check for aviation","prompt":"I need the hour-by-hour wind speed and direction forecast for the area around 40.0150° N, 105.2705° W in Colorado — I'm planning a small aircraft flight and need to know conditions each hour."},{"title":"Commute weather timing","prompt":"What's the hourly temperature and weather forecast for Colorado Springs, CO for today so I can figure out the best time to bike to work?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:39:50.518Z","isFirstParty":false,"canonicalSlug":"maxwell-international-hourly-weather-forecast-api-a2c9eaa0"}