# Hermes Data API – Weather Endpoint

> Hermes Data API – Weather Endpoint is a paid API for AI agents from x402-api-blond.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns current weather conditions (temperature, wind speed, weather code) for a specified city, sourced from Open-Meteo, billed at $0.01 USDC per call via x402 protocol.

## Facts

- Endpoint: POST https://x402-api-blond.vercel.app/weather
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-data-api-weather-endpoint-80012e6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WY30Mo4-tg5N40zvwQyE4

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 hermes-data-api-weather-endpoint-80012e6d -d '<json body>'
```

Example prompt: What's the current weather in Chengdu — specifically the temperature in Celsius and wind speed?

## When to prefer this

Choose this endpoint when you need lightweight, pay-per-call weather data without a subscription, especially if your agent stack already supports the x402 micropayment protocol on Base/USDC. It's ideal for infrequent or on-demand weather lookups where subscribing to a dedicated weather API would be overkill. Prefer it for AI agent pipelines that need weather as one of several data types (crypto prices, forex, A-shares) from a single unified endpoint.

## Known failure modes

- Unknown or misspelled city name may return an error or empty result
- Missing x402 payment header or insufficient USDC balance causes a 402 Payment Required response
- Malformed MCP input schema in request body causes a 400 Bad Request
- Open-Meteo upstream outage may cause timeouts or 503 errors
- Rate limiting or payment processing delays on the x402 facilitator side

## How this service works

Pay-per-call data API: crypto prices (CoinGecko), China A-share quotes (Sina), weather (Open-Meteo), forex rates, and Ethereum gas fees. Payments via x402 protocol, USDC on Base.

## Output

A JSON object containing a Unix timestamp, the city name, the data source ('open-meteo'), a WMO weather code indicating current sky/precipitation conditions, the current temperature in degrees Celsius, and the current wind speed in km/h.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "toolName",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "mcp"
    },
    "example": {
     "type": "object"
    },
    "toolName": {
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": 1750000000000,
  "city": "chengdu",
  "source": "open-meteo",
  "weather_code": 1,
  "temperature_c": 25.4,
  "wind_speed_kmh": 8.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-data-api-weather-endpoint-80012e6d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api-blond.vercel.app](https://www.zero.xyz/host/x402-api-blond.vercel.app/llms.txt)