# OneShot Agent API – Place Weather Alerts Lookup

> OneShot Agent API – Place Weather Alerts Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Returns active NWS weather alerts (flood warnings, severe thunderstorm watches, etc.) for a given geographic coordinate

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-place-weather-alerts-lookup-7b9c726b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wH1Q3JPWqF5-nzhwFtMuT

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 oneshot-agent-api-place-weather-alerts-lookup-7b9c726b -d '<json body>'
```

Example prompt: Are there any active NWS weather alerts right now at latitude 29.7604, longitude -95.3698? I want to know if there are flood warnings or severe weather watches in that area.

## When to prefer this

Use this endpoint when you need real-time, official NWS weather alert data for a specific geographic point, especially for safety-critical decisions (field operations, outdoor events, routing). Prefer this over general weather APIs when you specifically need structured emergency alert data with severity, urgency, and official NWS instructions rather than forecasts or current conditions.

## Known failure modes

- Coordinates outside valid range (latitude 17–72 or longitude -180 to -64) return a validation error
- No alerts active returns total: 0 with an empty alerts array
- NWS upstream outage may return a 500 or timeout
- Malformed JSON body returns a 400 error
- Payment failure via x402 returns a 402 before the lookup is executed

## How this service works

List the weather watches, warnings and advisories active at a US point, including those issued but not yet begun.

## Output

Returns a JSON object with a total count of active alerts and an array of alert objects. Each alert includes the event type (e.g. 'Flood Warning'), affected area description, sender (NWS office), severity, urgency, certainty, headline, onset/effective/expires timestamps, a detailed description, and any official safety instructions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "number",
   "description": "Latitude in decimal degrees, for example 29.7604. From 17 to 72."
  },
  "longitude": {
   "type": "number",
   "description": "Longitude in decimal degrees (west is negative), for example -95.3698. From -180 to -64."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "alerts": [
   {
    "area": "Hardin, TX; Jasper, TX; Jefferson, TX; Orange, TX",
    "event": "Flood Warning",
    "sender": "NWS Lake Charles LA",
    "ends_at": null,
    "urgency": "Immediate",
    "headline": "Flood Warning issued October 12 at 10:35AM CDT by NWS Lake Charles LA",
    "onset_at": "2026-10-12T10:35:00-05:00",
    "severity": "Severe",
    "certainty": "Observed",
    "expires_at": "2026-10-13T01:00:00-05:00",
    "description": "The Flood Warning is extended for the following rivers.",
    "instruction": "Turn around, do not drown when encountering flooded roads.",
    "effective_at": "2026-10-12T10:35:00-05:00"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-place-weather-alerts-lookup-7b9c726b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)