{"uid":"cap_DXAMFlJXvL70AMU2cYC30","slug":"agentbodega-us-weather-forecast-e30b5d30","name":"AgentBodega US Weather Forecast","description":"Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.","url":"https://agentbodega.store/api/public-data/us-weather-forecast","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"fields":[{"name":"lat","type":"number","required":false},{"name":"lon","type":"number","required":false},{"name":"zip","type":"string","required":false},{"name":"city","type":"string","required":false},{"name":"state","type":"string","required":false},{"name":"location","type":"string","required":false},{"name":"includeCurrent","type":"boolean","required":false},{"name":"includeHourly","type":"boolean","required":false},{"name":"includeAlerts","type":"boolean","required":false},{"name":"includeOffice","type":"boolean","required":false},{"name":"hourlyLimit","type":"integer","required":false},{"name":"dailyLimit","type":"integer","required":false}],"required":[],"fieldCount":13,"contentType":"application/json","optionalPreview":["lat","lon","zip","city","state","location","includeCurrent","includeHourly","includeAlerts","includeOffice","hourlyLimit","dailyLimit"],"omittedFieldCount":1},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}}},"output":{"type":"object","properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"grid":{"wfo":"BOU","gridX":54,"gridY":74},"tool":{"id":"us-weather-forecast","name":"US Weather Forecast","department":"Public Data"},"alerts":[],"success":true,"location":{"lat":40.015,"lon":-105.2705,"input":"Boulder, CO","time_zone":"America/Denver","relative_location":{"city":"Boulder","state":"CO"}},"forecast_hourly":[{"start_time":"2026-07-03T18:00:00-06:00","temperature":72,"short_forecast":"Sunny","temperature_unit":"F"}],"forecast_multi_day":[{"name":"Tonight","temperature":54,"short_forecast":"Partly Cloudy","temperature_unit":"F"}],"current_observation":{"station_id":"KBDU","temperature_f":71.6,"text_description":"Mostly Cloudy"}}},"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_NiSVglccN6db8hfbt-vxa","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 current conditions, hourly forecasts, multi-day forecasts, and weather alerts for any US location via coordinates, ZIP, or city name.","exampleAgentPrompt":"What's the weather looking like in Boulder, CO right now? Include current conditions, tonight's forecast, and the next 12 hours of hourly data — and flag any active weather alerts.","exampleUseCases":[{"title":"Outdoor event planning weather check","prompt":"I'm planning an outdoor event in Austin, TX this weekend — can you pull the multi-day forecast plus hourly breakdown for Saturday and Sunday, and let me know if there are any weather alerts I should worry about?"},{"title":"Travel packing forecast lookup","prompt":"I'm flying into Denver, CO tomorrow — what are the current conditions and the next 5-day forecast there so I know what to pack?"},{"title":"Automated weather enrichment by ZIP","prompt":"Get me the current temperature and short forecast for ZIP code 10001 and include whether there are any active alerts for that area."}],"resultDescription":"A JSON object containing: NWS grid info (WFO, gridX, gridY), resolved location (lat/lon, timezone, city/state), current observation from the nearest station (temperature in °F, text description, station ID), an array of hourly forecast periods (start time, temperature, short forecast), a multi-day forecast array (period name, temperature, short forecast), and a weather alerts array. Success flag is included.","failureModes":["Location not resolvable — if the provided city/state/ZIP/coordinates cannot be geocoded to a US NWS grid, the response will indicate failure","Non-US location — this endpoint only covers US territories served by NOAA/NWS; international coordinates will fail","Ambiguous city name without state — may resolve to wrong location or fail","NWS upstream outage — NOAA APIs occasionally have downtime causing empty or error responses","Payment failure — x402 micropayment of $0.005 USDC must succeed before the request is processed"],"whenToPreferThis":"Choose this endpoint when you need structured US weather data (current conditions, hourly, multi-day, alerts) in a single call without managing NOAA API keys or geocoding yourself. It accepts flexible location inputs (lat/lon, ZIP, city+state, or free-text) making it ideal for agent workflows where the location format may vary. At $0.005 USDC per call it suits occasional to moderate usage. Prefer a dedicated weather platform if you need international coverage or very high-volume polling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:50.320Z","isFirstParty":false}