{"openapi":"3.0.3","info":{"title":"Weather alerts and forecasts (Agent Data API)","description":"Active weather alerts (NWS CAP, and BoM warnings where licensed), current observations (NWS stations, NOAA ISD) and hourly and daily forecasts (NWS gridpoints for the US, NOAA GFS subsets for Australia) for any coordinate in the United States or Australia, normalised into one schema with a coverage field.","version":"2026.11.09"},"paths":{"/api/v1/alerts":{"get":{"tags":["Weather alerts and forecasts"],"summary":"Active weather alerts","description":"Active alerts for a region: a US state (TX), an NWS zone or county code (TXZ229, TXC201), an Australian state (NSW) or a whole country (US, AU). Severity first, newest first. Refreshes every 60 seconds.","operationId":"weather_alerts","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"region","in":"query","required":true,"schema":{"type":"string","description":"US state, NWS UGC zone or county code, Australian state, or US / AU","example":"TX","title":"Region"},"description":"US state, NWS UGC zone or county code, Australian state, or US / AU","example":"TX"},{"name":"severity","in":"query","required":false,"schema":{"type":"string","nullable":true,"title":"Severity","description":"Extreme, Severe, Moderate, Minor or Unknown","examples":["Severe"]},"description":"Extreme, Severe, Moderate, Minor or Unknown"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.002","x-price":{"price_micro":2000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"weather_alerts","x-cadence":"Refreshes every 60 seconds."}},"/api/v1/alerts/{alert_id}":{"get":{"tags":["Weather alerts and forecasts"],"summary":"One alert","description":"One alert by id with description, instruction, areas, zone codes and polygon. The id `latest` is the most severe active alert right now (a stable id for probes and examples). Refreshes every 60 seconds.","operationId":"alert_weather_api_v1_alerts__alert_id__get","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"},"example":"latest"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.002","x-price":{"price_micro":2000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"weather_alert","x-cadence":"Refreshes every 60 seconds."}},"/api/v1/current":{"get":{"tags":["Weather alerts and forecasts"],"summary":"Current conditions","description":"Latest report from the nearest reporting station within 150 km of a coordinate in the United States or Australia. Refreshes every 5 minutes.","operationId":"weather_current","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"example":-33.87,"title":"Lat"},"example":-33.87},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"example":151.21,"title":"Lon"},"example":151.21}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.003","x-price":{"price_micro":3000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"weather_current","x-cadence":"Refreshes every 5 minutes."}},"/api/v1/forecast/hourly":{"get":{"tags":["Weather alerts and forecasts"],"summary":"Hourly forecast","description":"GFS 0.25 degree hourly forecast at the nearest grid cell to a coordinate in the contiguous United States or Australia, 1 to 120 hours ahead (hourly to 48 h, then 3-hourly). Refreshes every 60 minutes or on a new model cycle.","operationId":"weather_forecast","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"example":-33.87,"title":"Lat"},"example":-33.87},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"example":151.21,"title":"Lon"},"example":151.21},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"example":48,"default":48,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.005","x-price":{"price_micro":5000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"weather_forecast_hourly","x-cadence":"Refreshes every 60 minutes or on a new model cycle.","x-cache-ttl-s":1800}},"/api/v1/forecast/daily":{"get":{"tags":["Weather alerts and forecasts"],"summary":"Daily forecast","description":"Daily summary (min and max temperature, mean humidity and cloud, max wind and gust, precipitation total) for a coordinate in the contiguous United States or Australia, 1 to 5 days, aggregated per UTC day from the GFS hourly series. Refreshes every 60 minutes or on a new model cycle.","operationId":"weather_forecast_daily","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"example":-33.87,"title":"Lat"},"example":-33.87},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"example":151.21,"title":"Lon"},"example":151.21},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":5,"minimum":1,"example":3,"default":3,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.005","x-price":{"price_micro":5000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"weather_forecast_daily","x-cadence":"Refreshes every 60 minutes or on a new model cycle.","x-cache-ttl-s":1800}},"/api/v1/stations/near":{"get":{"tags":["Weather alerts and forecasts"],"summary":"Reporting stations near a point","description":"METAR reporting stations within a radius of a coordinate in the United States or Australia, nearest first. Refreshes every 24 hours.","operationId":"weather_stations_near","security":[{"ApiKeyAuth":[]},{}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"example":-33.87,"title":"Lat"},"example":-33.87},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"example":151.21,"title":"Lon"},"example":151.21},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","maximum":500,"exclusiveMinimum":0,"example":50,"default":50,"title":"Radius Km"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment required (x402). Body lists accepts[] with USDC amount, network and payTo."}},"x-price-usdc":"0.001","x-price":{"price_micro":1000,"asset":"USDC","network":"eip155:8453"},"x-payment":"x402","x-payment-route-id":"weather_stations_near","x-cadence":"Refreshes every 24 hours."}}},"components":{"schemas":{"APIKeyCreate":{"properties":{"email":{"type":"string","title":"Email","description":"Where this key belongs. Agents: your human's real address, else your own mailbox.","example":"owner@yourcompany.com"}},"type":"object","required":["email"],"title":"APIKeyCreate"},"AgentSubscribeRequest":{"properties":{"plan":{"type":"string","title":"Plan","description":"pass_1h, pass_1d or pass_7d","example":"pass_1d"}},"type":"object","required":["plan"],"title":"AgentSubscribeRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"servers":[{"url":"https://agentdataapi.com/weather"}],"tags":[{"name":"Weather alerts and forecasts","description":"Weather alerts, current observations and forecasts for the United States and Australia from public-domain sources."}]}