Daily weather forecasts for any city worldwide via x402 micropayment at $0.01 per call.
What it does
The Weather Forecast endpoint at weather.hugen.tokyo provides structured JSON weather forecasts for any city worldwide. You can query by city name or by latitude/longitude coordinates, and request between 1 and 7 days of forecast data (defaulting to 3 days). Each forecast day includes condition description, weather code, max/min temperatures in Celsius, precipitation in mm, precipitation probability percentage, and maximum wind speed in km/h.
The endpoint is gated by the x402 protocol, requiring a micropayment of $0.01 USDC on the Base network per request. No API keys or geocoding setup are needed — just pass a city name or coordinates. The response schema is well-defined via OpenAPI 3.1, returning a ForecastResponse object with city, country, latitude, longitude, and an array of ForecastDay objects.
Alternative access methods are available: an MCP gateway at mcp.hugen.tokyo, an API key system with $0.05 free credit via discovery.hugen.tokyo, and a Python SDK (x402-pay) for one-line access without wallet setup. The API also offers a companion /weather/current endpoint for real-time conditions.
Capabilities
Use cases
- —AI agents fetching weather forecasts to plan user activities or travel
- —Chatbots providing multi-day weather outlooks for any city
- —Automated dashboards displaying upcoming weather conditions
- —Travel planning tools that need structured forecast data
- —IoT or smart-home systems querying upcoming weather for scheduling
Fit
Best for
- —Agent-to-agent weather data retrieval with per-call micropayments
- —Quick city-name-based forecast lookups without API key management
- —Structured JSON forecast consumption by LLM-powered applications
Not for
- —Historical weather data analysis (only provides future forecasts)
- —High-resolution hourly or sub-daily forecasts (only daily granularity)
- —Free unlimited bulk weather data scraping
Quick start
curl "https://weather.hugen.tokyo/weather/forecast?city=Tokyo&days=3"Example
Response
{
"city": "Tokyo",
"days": [
{
"date": "2026-03-04",
"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
}Endpoint
Quality
Full OpenAPI 3.1 schema with well-defined request parameters and response models. Live x402 402 challenge confirmed with sample response data. Pricing is clear ($0.01 USDC on Base). Documentation is available via /docs but no dedicated prose docs, examples, or pricing page exist beyond the OpenAPI spec and challenge payload.
Warnings
- —Root URL returns 404; no landing page — only /docs and the API endpoints are functional
- —No dedicated pricing page; price is inferred solely from the x402 challenge payload
- —Upstream weather data source is not disclosed
Citations
- —Endpoint returns x402 402 challenge requiring $0.01 USDC on Basehttps://weather.hugen.tokyo/weather/forecast
- —OpenAPI 3.1 spec describes forecast endpoint with city, lat, lon, days parameters and ForecastResponse schemahttps://weather.hugen.tokyo/docs
- —API described as: Instant weather data by city name — no API keys, no geocoding setup, no rate limitshttps://weather.hugen.tokyo/docs
- —Alternative access via MCP gateway, API key, and Python SDKhttps://weather.hugen.tokyo/weather/forecast