# AgentPay Weather Data

> AgentPay Weather Data is a paid API for AI agents from agentpay.help, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns current weather conditions and multi-day forecasts for any city or place, paid per-call with USDC via x402.

## Facts

- Endpoint: POST https://agentpay.help/v1/weather-data
- 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/agentpay-weather-data-afe5752b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cNl80cCKkQW4TWBx_pPwY

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 agentpay-weather-data-afe5752b -d '<json body>'
```

Example prompt: What's the current weather and 5-day forecast for Dubai? I need the temperature in Celsius and the general conditions each day.

## When to prefer this

Choose this endpoint when you need lightweight, on-demand weather lookups without setting up API keys or accounts — ideal for AI agents that pay per call in USDC via the x402 protocol and need current conditions plus short-range forecasts for any global city.

## Known failure modes

- Unrecognized or ambiguous location name returns an error or empty result
- Payment failure via x402 results in 402 Payment Required with no data returned
- Requesting more forecast days than supported may return a truncated result
- Network timeout if the upstream weather provider is slow

## How this service works

Pay-per-call AI services via the 402 Payment Required protocol. No accounts, no API keys — just USDC on Base.

## Output

Returns a JSON object with a 'current' block (temp_c, conditions) and a 'forecast' array of daily entries (date, temp_max_c), plus the resolved location name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "number",
   "description": "Forecast days, optional"
  },
  "location": {
   "type": "string",
   "description": "City or place name"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "current": {
   "temp_c": 38,
   "conditions": "clear"
  },
  "forecast": [
   {
    "date": "2026-09-13",
    "temp_max_c": 39
   }
  ],
  "location": "Dubai"
 }
}
```

## More

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