# WeatherXM Agent API – Current Weather Conditions

> WeatherXM Agent API – Current Weather Conditions is a paid API for AI agents from agent.weatherxm.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns real-time weather conditions (temperature, humidity, wind, UV index, pressure, precipitation) for a given latitude/longitude coordinate

## Facts

- Endpoint: GET https://agent.weatherxm.com/api/current
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/weatherxm-agent-api-current-weather-conditions-fb07ed01
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h9J7xowZ8P5_PYsT0opj8

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 weatherxm-agent-api-current-weather-conditions-fb07ed01
```

Example prompt: What's the current weather at coordinates 37.98°N, 23.73°E — give me the temperature, humidity, wind speed, and UV index in metric units using the Europe/Athens timezone?

## When to prefer this

Use this endpoint when you need point-in-time, real-time weather observations for a specific geographic coordinate and require structured numeric data (temperature, wind, humidity, etc.). Prefer this over forecast endpoints when you need current conditions rather than future predictions, and over historical endpoints when you need the latest reading rather than past data. The WeatherXM network sources data from decentralized ground-level weather stations, making it well-suited for hyperlocal current conditions.

## Known failure modes

- Missing or out-of-range lat/lon parameters returns a 400 bad request
- Invalid unit enum value (not 'metric' or 'imperial') causes a validation error
- Payment not included or insufficient USDC causes a 402 Payment Required response
- Coordinates over open ocean or remote areas with no nearby station may return no data or an error
- Invalid or unrecognized IANA timezone string may return an error or fall back to UTC

## How this service works

Current weather conditions for a location

## Output

A JSON object containing current weather observations for the requested coordinates, including: temperature (°C or °F), apparent temperature, humidity (%), wind speed, wind direction (degrees), UV index, atmospheric pressure (hPa), precipitation, timestamp of the reading, IANA timezone, and the echoed lat/lon location.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "tz": "Europe/Athens",
   "lat": 37.98,
   "lon": 23.73,
   "units": "metric"
  }
 },
 "output": {
  "type": "object"
 }
}
```

## 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": {
      "tz": {
       "type": "string",
       "description": "IANA timezone (e.g., Europe/Athens) or \"auto\""
      },
      "lat": {
       "type": "number",
       "description": "Latitude (-90 to 90)"
      },
      "lon": {
       "type": "number",
       "description": "Longitude (-180 to 180)"
      },
      "units": {
       "enum": [
        "metric",
        "imperial"
       ],
       "type": "string",
       "description": "Unit system: \"metric\" (default) or \"imperial\""
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Current weather data including temperature, wind, humidity, etc."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "units": "metric",
  "current": {
   "time": "2025-01-05T12:00:00+02:00",
   "uvIndex": 3,
   "humidity": 65,
   "pressure": 1013.2,
   "windSpeed": 12.5,
   "temperature": 15.2,
   "precipitation": 0,
   "windDirection": 180,
   "apparentTemperature": 14.5
  },
  "location": {
   "lat": 37.98,
   "lon": 23.73
  },
  "timezone": "Europe/Athens"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/weatherxm-agent-api-current-weather-conditions-fb07ed01/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.weatherxm.com](https://www.zero.xyz/host/agent.weatherxm.com/llms.txt)