curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 30.1487,
"longitude": -94.0188
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 30.1487,
"longitude": -94.0188
}),
});
const result = await agent.tool('lookup/place-weather-alerts', {
latitude: 30.1487,
longitude: -94.0188
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_weather_alerts",
"result": {
"total": 1,
"alerts": [
{
"event": "Flood Warning",
"severity": "Severe",
"certainty": "Observed",
"urgency": "Immediate",
"headline": "Flood Warning issued October 12 at 10:35AM CDT by NWS Lake Charles LA",
"description": "The Flood Warning is extended for the following rivers.",
"instruction": "Turn around, do not drown when encountering flooded roads.",
"area": "Hardin, TX; Jasper, TX; Jefferson, TX; Orange, TX",
"sender": "NWS Lake Charles LA",
"effective_at": "2026-10-12T10:35:00-05:00",
"onset_at": "2026-10-12T10:35:00-05:00",
"expires_at": "2026-10-13T01:00:00-05:00",
"ends_at": null
}
]
},
"evidence": {
"source": "US National Weather Service",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Weather Alerts
List the weather watches, warnings and advisories active at a US point, including those issued but not yet begun.
POST
/
v1
/
tools
/
lookup
/
place-weather-alerts
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 30.1487,
"longitude": -94.0188
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 30.1487,
"longitude": -94.0188
}),
});
const result = await agent.tool('lookup/place-weather-alerts', {
latitude: 30.1487,
longitude: -94.0188
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_weather_alerts",
"result": {
"total": 1,
"alerts": [
{
"event": "Flood Warning",
"severity": "Severe",
"certainty": "Observed",
"urgency": "Immediate",
"headline": "Flood Warning issued October 12 at 10:35AM CDT by NWS Lake Charles LA",
"description": "The Flood Warning is extended for the following rivers.",
"instruction": "Turn around, do not drown when encountering flooded roads.",
"area": "Hardin, TX; Jasper, TX; Jefferson, TX; Orange, TX",
"sender": "NWS Lake Charles LA",
"effective_at": "2026-10-12T10:35:00-05:00",
"onset_at": "2026-10-12T10:35:00-05:00",
"expires_at": "2026-10-13T01:00:00-05:00",
"ends_at": null
}
]
},
"evidence": {
"source": "US National Weather Service",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
List the weather watches, warnings and advisories in force now at a point in the United States, given its latitude and longitude. Use it to check whether a storm, flood, heat, fire-weather or winter-weather alert covers a property, a route stop or a claim location today. Alerts are ordered most severe first (Extreme, Severe, Moderate, Minor, Unknown), then by soonest to expire. The source’s active list is returned as it gives it: an alert already issued whose event has not begun (a watch for tomorrow, urgency Future,
onset_at in the future) is included, so check urgency and onset_at to tell what is under way from what is coming. total is the number of alerts returned. Expired and past alerts are not returned. A point with nothing active is a completed result with total 0.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
number
required
Latitude in decimal degrees, 17 to 72, for example 29.7604. From 17 to 72.
number
required
Longitude in decimal degrees, -180 to -64 (west is negative), for example -95.3698. From -180 to -64.
Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
place_weather_alertsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US National Weather Service.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
number
Number of alerts returned: those active at the point, including issued alerts whose event has not begun.
object[]
Alerts.
string
The alert type, for example Flood Warning or Winter Weather Advisory.
null when the source gives no value.string
Extreme, Severe, Moderate, Minor or Unknown.
null when the source gives no value.string
Observed, Likely, Possible, Unlikely or Unknown.
null when the source gives no value.string
Immediate, Expected, Future, Past or Unknown.
null when the source gives no value.string
Headline.
null when the source gives no value.string
Description.
null when the source gives no value.string
What the issuer advises people to do; null when none is given.
string
The area the alert covers, as the issuer names it.
null when the source gives no value.string
The issuing forecast office, for example NWS Lake Charles LA.
null when the source gives no value.string
ISO 8601, as the source gives it.
null when the source gives no value.string
ISO 8601, as the source gives it.
null when the source gives no value.string
ISO 8601, as the source gives it.
null when the source gives no value.string
ISO 8601, as the source gives it; null when the event has no set end.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 30.1487,
"longitude": -94.0188
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-weather-alerts", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 30.1487,
"longitude": -94.0188
}),
});
const result = await agent.tool('lookup/place-weather-alerts', {
latitude: 30.1487,
longitude: -94.0188
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_weather_alerts",
"result": {
"total": 1,
"alerts": [
{
"event": "Flood Warning",
"severity": "Severe",
"certainty": "Observed",
"urgency": "Immediate",
"headline": "Flood Warning issued October 12 at 10:35AM CDT by NWS Lake Charles LA",
"description": "The Flood Warning is extended for the following rivers.",
"instruction": "Turn around, do not drown when encountering flooded roads.",
"area": "Hardin, TX; Jasper, TX; Jefferson, TX; Orange, TX",
"sender": "NWS Lake Charles LA",
"effective_at": "2026-10-12T10:35:00-05:00",
"onset_at": "2026-10-12T10:35:00-05:00",
"expires_at": "2026-10-13T01:00:00-05:00",
"ends_at": null
}
]
},
"evidence": {
"source": "US National Weather Service",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Price: $0.002 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}