# greeneris-data US Weather Alerts

> greeneris-data US Weather Alerts is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Retrieves active US National Weather Service alerts filtered by state, marine area, GPS point, event type, or severity level

## Facts

- Endpoint: GET https://data.greeneris.io/v1/us/wx-alerts
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-data-us-weather-alerts-077d6fbb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZJm07dCjrlsgluOVy9ndW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability greeneris-data-us-weather-alerts-077d6fbb
```

Example prompt: Are there any Severe weather alerts active right now in California, specifically near the San Diego area? Pull from the National Weather Service.

## When to prefer this

Use this endpoint when you need real-time, official NWS weather alert data for US states or specific GPS points and want a simple pay-per-call model with no API key setup. Prefer this over raw api.weather.gov integration when you need normalized JSON output, severity filtering, and x402-compatible micropayment access. Especially suited for AI agents that need to surface actionable safety alerts without maintaining credentials.

## Known failure modes

- No alerts match the given filters — returns count:0 and empty alerts array
- Invalid state code returns an error or empty result
- Malformed GPS point format causes a 400 bad request
- HTTP 402 returned if payment not provided — endpoint requires $0.005 USDC via x402 protocol before serving data
- NWS upstream outage may cause delayed or missing data
- Unsupported severity enum value rejected at input validation

## How this service works

Active weather alerts from the US National Weather Service (NOAA, public domain, real-time feed). Query: ?area=CA (2-letter state code) or ?point=34.05,-118.24; optional severity=Extreme|Severe|Moderate|Minor and event='Tornado Warning'. Returns up to 50 normalized alerts: event, severity, urgency, headline, affected areas, onset/expiry. count=0 means no active alert matches. 2 min cache.

## Output

A JSON object containing a count of matching alerts, an array of alert objects (each with event name, onset and expiry timestamps, NWS sender office, severity, urgency, certainty, headline, and full description text), the data source attribution (NOAA/api.weather.gov), the applied filters, and a truncation flag.

## Request schema (JSON Schema)

```json
{
 "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",
     "properties": {
      "area": {
       "type": "string",
       "description": "2-letter US state or marine area code (e.g. CA)"
      },
      "event": {
       "type": "string",
       "description": "Exact event name, e.g. 'Tornado Warning'"
      },
      "point": {
       "type": "string",
       "description": "GPS point 'lat,lon' (alternative to area)"
      },
      "severity": {
       "enum": [
        "Extreme",
        "Severe",
        "Moderate",
        "Minor",
        "Unknown"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "alerts": [
   {
    "event": "Heat Advisory",
    "onset": "2026-07-13T14:57:00-07:00",
    "sender": "NWS San Diego CA",
    "expires": "2026-07-14T20:00:00-07:00",
    "urgency": "Expected",
    "headline": "Heat Advisory issued July 13 at 2:57PM PDT",
    "severity": "Severe",
    "area_desc": "San Gorgonio Pass Near Banning",
    "certainty": "Likely",
    "description": "* WHAT...Temperatures up to 106 expected..."
   }
  ],
  "source": "US National Weather Service (api.weather.gov, NOAA, public domain, real-time)",
  "filters": {
   "area": "CA",
   "severity": "Severe"
  },
  "truncated": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-data-us-weather-alerts-077d6fbb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)