{"uid":"cap_eBivqHvzQ_wOPCxKUgsm9","slug":"eckari-us-weather-forecast-7318057b","name":"Eckari US Weather Forecast","description":"Official National Weather Service forecast for any US coordinate - six 12-hour day/night periods by default, or hourly - each with temperature in C and F, precipitation probability, a wind speed range in km/h, wind direction and a short forecast, plus the NWS issue time so an agent can judge its age. detail=full adds the narrative, icon, dewpoint and humidity. United States, its territories and coastal waters only. Use when: What is the weather forecast for these US coordinates?","url":"https://api.eckari.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","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees (WGS84). Rounded to 4 decimal places before the National Weather Service lookup."},"hours":{"type":"integer","default":24,"maximum":48,"minimum":1,"description":"Number of hourly periods to return, soonest first. Applies when hourly is true; use period_limit for day/night forecasts."},"detail":{"enum":["compact","full"],"type":"string","default":"compact","description":"compact (default) returns the fields an agent acts on. full adds the NWS narrative (detailed_forecast), the icon URL, the trend note and, for hourly periods, dewpoint_c and humidity_pct."},"hourly":{"type":"boolean","default":false,"description":"Return hourly periods instead of the default 12-hour day/night periods. Hourly periods have no name and, at detail=full, carry dewpoint and humidity."},"period_limit":{"type":"integer","default":6,"maximum":14,"minimum":1,"description":"Maximum number of 12-hour day/night periods to return, soonest first. Applies when hourly is false; use hours for hourly forecasts. NWS issues 14 periods (7 days); the default of 6 is three days. Named period_limit, not periods, because periods is the returned series."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"query":{"lat":38.8977,"lon":-77.0365,"hours":null,"detail":"compact","hourly":false,"period_limit":6},"periods":[{"name":"Today","end_time":"2026-08-18T18:00:00-04:00","is_daytime":true,"start_time":"2026-08-18T08:00:00-04:00","temperature_c":31.11,"temperature_f":88,"short_forecast":"Partly Sunny","wind_direction":"N","wind_speed_range_kmh":{"max":11.27,"min":4.83},"precipitation_probability_pct":11},{"name":"Tonight","end_time":"2026-08-19T06:00:00-04:00","is_daytime":false,"start_time":"2026-08-18T18:00:00-04:00","temperature_c":21.67,"temperature_f":71,"short_forecast":"Partly Cloudy","wind_direction":"NW","wind_speed_range_kmh":{"max":9.66,"min":1.61},"precipitation_probability_pct":1},{"name":"Wednesday","end_time":"2026-08-19T18:00:00-04:00","is_daytime":true,"start_time":"2026-08-19T06:00:00-04:00","temperature_c":32.22,"temperature_f":90,"short_forecast":"Sunny","wind_direction":"W","wind_speed_range_kmh":{"max":8.05,"min":8.05},"precipitation_probability_pct":0},{"name":"Wednesday Night","end_time":"2026-08-20T06:00:00-04:00","is_daytime":false,"start_time":"2026-08-19T18:00:00-04:00","temperature_c":22.78,"temperature_f":73,"short_forecast":"Partly Cloudy then Slight Chance Showers And Thunderstorms","wind_direction":"SW","wind_speed_range_kmh":{"max":8.05,"min":1.61},"precipitation_probability_pct":19},{"name":"Thursday","end_time":"2026-08-20T18:00:00-04:00","is_daytime":true,"start_time":"2026-08-20T06:00:00-04:00","temperature_c":31.11,"temperature_f":88,"short_forecast":"Showers And Thunderstorms Likely","wind_direction":"N","wind_speed_range_kmh":{"max":9.66,"min":1.61},"precipitation_probability_pct":70},{"name":"Thursday Night","end_time":"2026-08-21T06:00:00-04:00","is_daytime":false,"start_time":"2026-08-20T18:00:00-04:00","temperature_c":21.11,"temperature_f":70,"short_forecast":"Showers And Thunderstorms Likely","wind_direction":"NE","wind_speed_range_kmh":{"max":8.05,"min":1.61},"precipitation_probability_pct":70}],"location":{"city":"Washington","state":"DC","timezone":"America/New_York"},"updated_at":"2026-08-18T11:55:05.000Z","valid_from":"2026-08-18T05:00:00.000Z","generated_at":"2026-08-18T12:03:31.000Z"},"meta":{"source":"nws","version":"4.0.0","freshness":"near_live","capability":"weather.us.forecast"}}},"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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f3RZY8uR7Vte1Ya7tKMWa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official National Weather Service forecasts for any US coordinate as structured day/night or hourly periods with temperatures, precipitation probability, and wind data","exampleAgentPrompt":"What's the NWS weather forecast for the next 3 days at coordinates 38.8977°N, 77.0365°W? Give me the day/night periods with temperatures, wind, and precipitation chances.","exampleUseCases":[{"title":"Outdoor event weather planning","prompt":"I'm organizing an outdoor event in Denver on Thursday — can you pull the official NWS forecast for coordinates 39.7392°N, 104.9903°W and tell me the temperature highs, chance of rain, and wind conditions for Thursday and Thursday night?"},{"title":"Hourly forecast for travel routing","prompt":"I'm driving through Atlanta tomorrow and want to know hour-by-hour weather — grab me the next 12 hourly periods for 33.7490°N, 84.3880°W including temperature and precipitation probability."},{"title":"Agricultural field conditions check","prompt":"Check the 7-day NWS day/night forecast for our farm at 41.8500°N, 93.6250°W in Iowa — I need all 14 periods with full detail including humidity and dewpoint so I can plan irrigation."}],"resultDescription":"A JSON object containing an array of forecast periods, each with: period name (e.g. 'Tonight', 'Wednesday'), start/end times, daytime flag, temperature in both Celsius and Fahrenheit, short forecast text, wind direction, wind speed range in km/h, and precipitation probability percentage. With detail=full, also includes NWS narrative text, icon URL, dewpoint, and humidity. The query echo and NWS issue time are also returned so the agent can assess data freshness.","failureModes":["Coordinates outside US territories or coastal waters return an error (NWS only covers US)","Invalid lat/lon values outside -90 to 90 or -180 to 180 ranges are rejected","NWS upstream outages may cause delayed or failed responses","Requesting hourly=true but using period_limit parameter (instead of hours) may cause confusion — they are separate parameters","Coordinates in US waters far from forecast grid points may return no data"],"whenToPreferThis":"Use this endpoint when you need official NOAA/NWS forecast data for US coordinates in a structured, agent-ready format with both metric and imperial units already included. Prefer this over raw NWS API calls because it normalizes the NWS response, provides dual temperature units, and returns structured wind ranges. Best for US-only use cases; do not use for international weather lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:43:37.052Z","isFirstParty":false,"canonicalSlug":"eckari-us-weather-forecast-7318057b"}