curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-wildfires \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 44.7,
"longitude": -120,
"radius_km": 100,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-wildfires", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 44.7,
"longitude": -120,
"radius_km": 100,
"limit": 1
}),
});
const result = await agent.tool('lookup/place-wildfires', {
latitude: 44.7,
longitude: -120,
radius_km: 100,
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_wildfires",
"result": {
"wildfires": [
{
"name": "Crosswhite",
"acres": 342923,
"percent_contained": 100,
"discovered_on": "2026-07-16",
"state": "OR",
"county": "Wheeler"
}
],
"more": true
},
"evidence": {
"source": "US National Interagency Fire Center",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Wildfires
List the wildfires burning near a point in the United States, largest first, with size, containment and discovery date.
POST
/
v1
/
tools
/
lookup
/
place-wildfires
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-wildfires \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 44.7,
"longitude": -120,
"radius_km": 100,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-wildfires", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 44.7,
"longitude": -120,
"radius_km": 100,
"limit": 1
}),
});
const result = await agent.tool('lookup/place-wildfires', {
latitude: 44.7,
longitude: -120,
radius_km: 100,
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_wildfires",
"result": {
"wildfires": [
{
"name": "Crosswhite",
"acres": 342923,
"percent_contained": 100,
"discovered_on": "2026-07-16",
"state": "OR",
"county": "Wheeler"
}
],
"more": true
},
"evidence": {
"source": "US National Interagency Fire Center",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
List the wildfires currently burning within a distance of a point, given its latitude and longitude. Use it to check fire activity around a property, a facility or a route stop. Fires are returned largest first, each with its name, size in acres, the percent contained (null when the source states none), the date it was discovered (YYYY-MM-DD, UTC), and its state and county.
radius_km sets the distance (1 to 200, default 50) and limit the most returned (1 to 25, default 10); more is true when the source held more fires in range than were returned. Covers current wildfire perimeters in the United States. A point with no fire in range is a completed result with an empty list; that means no published perimeter matched, not that no fire is near: a new fire may not have a perimeter yet.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
number
required
Latitude in decimal degrees, -90 to 90, for example 44.7. From -90 to 90.
number
required
Longitude in decimal degrees, -180 to 180 (west is negative), for example -120.0. From -180 to 180.
number
Distance from the point in kilometres, 1 to 200; default 50. From 1 to 200. Defaults to
50.integer
Most fires to return, 1 to 25; default 10. From 1 to 25. Defaults to
10.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_wildfiresobject
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 Interagency Fire Center.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.
object[]
Wildfires.
string
The incident name.
null when the source gives no value.number
Size of the fire in acres.
null when the source gives no value.number
Percent of the fire perimeter contained, 0 to 100; null when none is stated.
string
Date the fire was discovered, YYYY-MM-DD (UTC).
null when the source gives no value.string
Two-letter state code where the fire started.
null when the source gives no value.string
County where the fire started.
null when the source gives no value.boolean
True when the source held more fires in range than were returned.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-wildfires \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 44.7,
"longitude": -120,
"radius_km": 100,
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-wildfires", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 44.7,
"longitude": -120,
"radius_km": 100,
"limit": 1
}),
});
const result = await agent.tool('lookup/place-wildfires', {
latitude: 44.7,
longitude: -120,
radius_km: 100,
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_wildfires",
"result": {
"wildfires": [
{
"name": "Crosswhite",
"acres": 342923,
"percent_contained": 100,
"discovered_on": "2026-07-16",
"state": "OR",
"county": "Wheeler"
}
],
"more": true
},
"evidence": {
"source": "US National Interagency Fire Center",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Price: $0.005 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}