# ForgeMesh Weather Forecast API

> ForgeMesh Weather Forecast API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns current weather conditions and a 3-day daily forecast (highs, lows, precipitation probability) for any latitude/longitude worldwide as structured JSON.

## Facts

- Endpoint: POST https://x402.forgemesh.io/weather-forecast
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-weather-forecast-api-6dd57772
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2BL1_Iwuh1CIJXvv--I0e

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 forgemesh-weather-forecast-api-6dd57772 -d '<json body>'
```

Example prompt: What's the current weather and 3-day forecast at latitude 29.76, longitude -95.36? I need temperature, feels-like, humidity, wind, and daily highs, lows, and rain chances.

## When to prefer this

Choose this endpoint when you need structured, machine-readable current conditions plus a short-range 3-day forecast for any global coordinate pair, especially for travel planning, logistics routing, or assistant agent workflows. It is preferable over general weather APIs when you need a pay-per-call model with no subscription, worldwide coordinate-based lookup, and cached JSON output ready for downstream processing.

## Known failure modes

- Invalid or out-of-range latitude/longitude values return an error
- Missing required latitude or longitude fields result in a 400-level error
- Payment failure (insufficient USDC balance or x402 protocol error) blocks the request
- Coordinates over land-locked or polar regions may have reduced data accuracy
- Upstream weather data provider outage may result in 503 or stale cached data

## How this service works

Weather forecast API: current conditions (temperature, feels-like, humidity, wind, weather code) plus a 3-day daily forecast (highs, lows, precipitation probability) for any latitude/longitude worldwide, as structured JSON. Use for travel planning, logistics, event scheduling, and assistant agents. Cached 10 minutes.

## Output

A structured JSON object containing current conditions (temperature, feels-like, humidity, wind speed, weather code) and a 3-day daily forecast with high/low temperatures and precipitation probability for each day. Data is cached for 10 minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "string",
   "description": "Latitude, e.g. 29.76"
  },
  "longitude": {
   "type": "string",
   "description": "Longitude, e.g. -95.36"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "daily": {
    "temperature_2m_max": [
     31.2,
     29.8,
     30.1
    ]
   },
   "current": {
    "temperature_2m": 27.3,
    "wind_speed_10m": 12.1
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-weather-forecast-api-6dd57772/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)