# agent-utils-x402 US Weather Lookup

> agent-utils-x402 US Weather Lookup is a paid API for AI agents from agent-utils-x402-production.revenue-agent-jw.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-28).

Returns current weather conditions and active alerts for a US location given latitude and longitude coordinates.

## Facts

- Endpoint: GET https://agent-utils-x402-production.revenue-agent-jw.workers.dev/v1/weather/us?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-utils-x402-us-weather-lookup-4f569eb7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mVcSc2zO4HvRoH3pjck4p

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 agent-utils-x402-us-weather-lookup-4f569eb7
```

Example prompt: What's the current weather at latitude 43.22 and longitude -123.36? I need the temperature and whether there are any active alerts.

## When to prefer this

Choose this endpoint when you need lightweight, pay-per-call current US weather conditions without setting up accounts or API keys. Ideal for AI agents that need occasional weather lookups billed in USDC on Base via x402. Best for US-only use cases; not suitable for international weather or historical data.

## Known failure modes

- Coordinates outside the United States return no data or an error (endpoint is US-only)
- Invalid or missing lat/lon query parameters return a 400-level error
- x402 payment failure or insufficient USDC balance prevents the request from completing
- NWS data unavailability or outage may cause empty or error responses
- Coordinates in remote US areas may lack nearby observation stations

## How this service works

Small pay-per-call utility APIs for AI agents. Pay per request in USDC on Base via x402 (v2, exact scheme). No accounts, no API keys.

## Output

A JSON object containing the city and state of the resolved location, an array of active weather alerts (empty if none), and the latest observation including a text description (e.g. 'Cloudy') and temperature in Fahrenheit.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "location": {
   "city": "Roseburg",
   "state": "OR"
  },
  "activeAlerts": [],
  "latestObservation": {
   "text": "Cloudy",
   "tempF": 54.1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-utils-x402-us-weather-lookup-4f569eb7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-utils-x402-production.revenue-agent-jw.workers.dev](https://www.zero.xyz/host/agent-utils-x402-production.revenue-agent-jw.workers.dev/llms.txt)