# weather.hugen.tokyo Daily Forecast

> weather.hugen.tokyo Daily Forecast is a paid API for AI agents from weather.hugen.tokyo, paid per call via x402, $0.01/call, not verified (last probed 2026-10-10); live alternatives: NWS Multi-Period Weather Forecast ($0.001) and Weather Forecast ($0.001).

Agents call it through Zero, which pays per call: no API key and no wallet of your own. New accounts start with $5.

Live alternatives for the same use case:
- [NWS Multi-Period Weather Forecast](https://www.zero.xyz/c/nws-multi-period-weather-forecast-us-8ecf4277) ($0.001)
- [Weather Forecast](https://www.zero.xyz/c/zeroclick-x402-service-registry-weather-0cd7c167) ($0.001)

Returns a 1–7 day daily weather forecast (max/min temperature, precipitation, wind speed) for a given city name, with automatic geocoding.

## Facts

- Endpoint: GET https://weather.hugen.tokyo/weather/forecast?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-04-27
- Success rate: 38% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 21
- Tags: x402
- Canonical page: https://www.zero.xyz/c/weather-hugen-tokyo-f2f9109b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OjwQRn3QA3LzNiuUlcJrf

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 weather-hugen-tokyo-f2f9109b
```

Example prompt: What's the weather forecast for Osaka over the next 5 days — give me the daily highs, lows, precipitation chances, and wind speeds?

## When to prefer this

Use this endpoint when you need a structured multi-day daily weather forecast (up to 7 days) by city name and do not want to handle geocoding or API key setup. Prefer this over real-time/current-conditions endpoints when planning ahead, and over coordinate-based APIs when only a city name is available. Ideal for travel planning, scheduling, or workflow automation requiring structured JSON weather data.

## Known failure modes

- Unknown or misspelled city name returns an error or empty result
- Days value outside 1–7 range may return an error or be clamped
- Network timeout if geocoding or upstream weather service is slow
- Payment failure (402) if USDC payment is not provided or insufficient
- City name ambiguity (e.g. 'Springfield') may resolve to an unexpected location

## How this service works

Instant weather data by city name — no API keys, no geocoding setup, no rate limits. Current conditions and daily forecasts for any city worldwide in structured JSON, ready for agent consumption.

## Output

A JSON object containing the resolved city name, country, latitude/longitude, and an array of daily forecast objects — each with date, human-readable condition label, max and min temperature in Celsius, weather code, peak wind speed in km/h, precipitation in mm, and precipitation probability percentage.

## Example request

```json
{
 "city": "Tokyo",
 "days": 5
}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "Tokyo",
  "days": [
   {
    "date": "2026-02-21",
    "condition": "Slight rain",
    "temp_max_c": 15.2,
    "temp_min_c": 8.1,
    "weather_code": 61,
    "wind_max_kmh": 22,
    "precipitation_mm": 12.5,
    "precipitation_probability_pct": 85
   }
  ],
  "country": "Japan",
  "latitude": 35.6895,
  "longitude": 139.6917
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/weather-hugen-tokyo-f2f9109b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from weather.hugen.tokyo](https://www.zero.xyz/host/weather.hugen.tokyo/llms.txt)