{"uid":"cap_kM754cAHeH2kUprFFZuel","slug":"us-weather-forecast-nws-5602d200","name":"US Weather Forecast (NWS)","description":"Official National Weather Service forecast for a US location: 7-day day/night periods or hourly, with temperature, precipitation chance, wind and text forecast. US and territories only.","url":"https://bess-x402.onrender.com/v1/weather/us-forecast?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"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"},"hourly":{"type":"boolean","description":"Hourly instead of 12-hour periods"},"periods":{"type":"integer","description":"Periods to return (1-156)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MO4kQABXkoPXT5kgHpN-n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official NOAA/NWS 7-day day/night or hourly weather forecast for a US location by latitude and longitude, including temperature, precipitation chance, wind, and text descriptions.","exampleAgentPrompt":"What's the NWS 7-day forecast for Miami — I need temperature, precipitation chance, and wind for the next 7 periods? The coordinates are 25.7617 latitude, -80.1918 longitude.","exampleUseCases":[{"title":"Outdoor event planning check","prompt":"I'm organizing an outdoor event in Chicago this weekend — can you pull the official National Weather Service day-by-day forecast for the next 7 periods for coordinates 41.8781 latitude, -87.6298 longitude so I know what weather to expect?"},{"title":"Hourly forecast for a road trip","prompt":"I'm leaving Denver tomorrow morning and want to know the hour-by-hour weather along the way — can you get me the hourly NWS forecast for 39.7392 latitude, -104.9903 longitude for the next 24 periods?"},{"title":"Agriculture frost alert monitoring","prompt":"Can you check the NWS forecast for my farm near Fresno, California at 36.7378 latitude, -119.7871 longitude and tell me if overnight temperatures are going to drop below freezing in the next 14 periods?"}],"resultDescription":"Returns an array of forecast periods, each containing: period name (e.g. 'Tonight', 'Monday'), start and end times, temperature and unit, precipitation probability, wind speed and direction, short forecast text, and a detailed forecast description. Supports both 12-hour day/night periods (default) and hourly intervals.","failureModes":["Coordinates outside US or territories return an error — international locations are not supported","Invalid or out-of-range latitude/longitude values cause a 400-level error","NWS API upstream outage may cause 503 or timeout responses","Requesting more periods than available data may silently return fewer periods","Missing required lat or lon query parameters will return a validation error"],"whenToPreferThis":"Choose this endpoint when you need official US government weather forecasts sourced directly from NOAA/NWS, especially when data authority or accuracy for US locations is important. Prefer this over commercial weather APIs when the user is in the US or its territories and needs structured day/night or hourly forecast data with wind and precipitation. Not suitable for international locations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:35:19.703Z","isFirstParty":false,"canonicalSlug":"us-weather-forecast-nws-5602d200"}