{"uid":"cap_bXCNkAtFXo3RP0kqIuJoS","slug":"agentutility-weather-api-bee90db6","name":"AgentUtility Weather API","description":"Current conditions and forecast for any latitude/longitude. Returns present weather plus a 1-7 day daily forecast (temp max/min, precipitation, sunrise/sunset, UV index) and an optional hourly forecast. A simple weather API on the Open-Meteo backend.","url":"https://x402.agentutility.ai/weather","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["latitude","longitude"],"properties":{"units":{"enum":["metric","imperial"],"type":"string","description":"'metric' (°C, km/h, mm) or 'imperial' (°F, mph, inch). Default 'metric'."},"hourly":{"type":"boolean","description":"If true, include hourly temperature, precipitation, and weather code arrays. Default false."},"latitude":{"type":"number","description":"Decimal degrees, range [-90, 90]. Positive north."},"longitude":{"type":"number","description":"Decimal degrees, range [-180, 180]. Positive east."},"forecast_days":{"type":"number","description":"Number of forecast days, 1-7. Default 3."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"sunset":{"type":"string"},"sunrise":{"type":"string"},"uv_index_max":{"type":"number"},"weather_code":{"type":"integer"},"temperature_max":{"type":"number"},"temperature_min":{"type":"number"},"precipitation_mm":{"type":"integer"},"precipitation_probability_max":{"type":"integer"}}}},"units":{"type":"string"},"source":{"type":"string"},"current":{"type":"object","properties":{"time":{"type":"string"},"is_day":{"type":"boolean"},"wind_speed":{"type":"number"},"temperature":{"type":"number"},"humidity_pct":{"type":"integer"},"weather_code":{"type":"integer"},"precipitation":{"type":"integer"},"wind_direction_deg":{"type":"integer"},"apparent_temperature":{"type":"number"}}},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"timezone":{"type":"string"},"elevation_m":{"type":"integer"}}}}}}}}},"responseSchema":{"type":"json","example":{"daily":[{"date":"2026-05-06","sunset":"2026-05-06T20:11","sunrise":"2026-05-06T06:08","uv_index_max":7.5,"weather_code":3,"temperature_max":67.3,"temperature_min":53.1,"precipitation_mm":0,"precipitation_probability_max":5}],"units":"imperial","source":"https://open-meteo.com","current":{"time":"2026-05-06T13:00","is_day":true,"wind_speed":8.2,"temperature":62.1,"humidity_pct":78,"weather_code":3,"precipitation":0,"wind_direction_deg":270,"apparent_temperature":60.4},"location":{"lat":37.7749,"lon":-122.4194,"timezone":"America/Los_Angeles","elevation_m":18}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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_EqNLE6k8MPWqSbcvkUsUx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current weather conditions plus a 1–7 day daily forecast (and optional hourly) for any latitude/longitude coordinate, powered by Open-Meteo.","exampleAgentPrompt":"What's the current weather and 5-day forecast for latitude 40.7128, longitude -74.0060? Include daily high/low temperatures, precipitation, UV index, and sunrise/sunset times.","exampleUseCases":[{"title":"Outdoor event planning weather check","prompt":"I'm planning an outdoor event in Paris this weekend — can you pull the 3-day forecast for latitude 48.8566, longitude 2.3522? I need daily highs and lows, precipitation chances, and UV index."},{"title":"Agricultural field monitoring","prompt":"Fetch current conditions and a 7-day daily forecast for my farm at latitude 41.8781, longitude -87.6298 — I need precipitation, temperature max/min, and sunrise/sunset so I can plan irrigation."},{"title":"Travel itinerary weather briefing","prompt":"What's the weather looking like for Tokyo right now and over the next 5 days? The coordinates are latitude 35.6762, longitude 139.6503 — give me highs, lows, rain, and UV levels each day."}],"resultDescription":"Returns a JSON object with current weather conditions (temperature, wind, precipitation, weather code) and a daily forecast array covering 1–7 days with fields for max/min temperature, precipitation sum, sunrise/sunset times, and UV index. Optionally includes an hourly forecast array with per-hour temperature and precipitation data.","failureModes":["Invalid or out-of-range latitude/longitude returns a 400 error","Missing required coordinate parameters returns a validation error","Upstream Open-Meteo service outage may result in 502/503 response","Payment authorization failure (insufficient USDC balance) blocks the request via x402 protocol","Requesting more than 7 forecast days may return an error or be clamped to max range"],"whenToPreferThis":"Choose this endpoint when an agent needs structured weather data (current conditions + multi-day forecast) for an arbitrary coordinate at a low fixed cost of $0.002 USDC per call. Ideal for agents that already have lat/lng from a geocoding step and need forecast data without managing Open-Meteo API keys directly. The x402 USDC micropayment model suits autonomous agents with crypto wallets operating without human-managed API subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T04:07:06.269Z","isFirstParty":false}