# India Weather API — Monsoon Onset by State

> India Weather API — Monsoon Onset by State is a paid API for AI agents from weatherapi.hillguava.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns monsoon onset and withdrawal dates for a given Indian state, including current season status based on IMD bulletins.

## Facts

- Endpoint: GET https://weatherapi.hillguava.xyz/monsoon/onset/%7Bstate%7D
- 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/india-weather-api-monsoon-onset-by-state-bcb308f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fO4M5D8Bp5tmQLwe5xspC

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 india-weather-api-monsoon-onset-by-state-bcb308f2
```

Example prompt: What's the monsoon onset status for Kerala this season — when does it normally start and has IMD confirmed it's active yet?

## When to prefer this

Use this endpoint when you need monsoon onset or withdrawal information specifically for Indian states, particularly when you want IMD-sourced seasonal data without requiring an API key. Prefer this over general weather APIs when the question is about monsoon seasonality rather than current conditions or temperature forecasts.

## Known failure modes

- State name not recognized or misspelled — may return null or error
- IMD bulletin data not yet available for the current season — status may be stale
- Payment of $0.005 USDC on Base not completed — 402 Payment Required returned
- State parameter missing from URL path — 404 or validation error
- Unsupported state (e.g. union territories not covered) — empty or error response

## How this service works

Pay-per-request 7-day weather forecasts for Indian cities. Powered by x402 — pay $0.001 USDC per call on Base, no account or API key needed.

## Output

A JSON object containing the queried state name, the current season year, the monsoon's current status per the latest IMD bulletin, the normal onset date, and the normal withdrawal date for that state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "state": "Kerala",
  "season": "2026",
  "status": "Likely active/mentioned in latest IMD bulletin.",
  "normal_onset": "June 01",
  "normal_withdrawal": "October 31"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/india-weather-api-monsoon-onset-by-state-bcb308f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from weatherapi.hillguava.xyz](https://www.zero.xyz/host/weatherapi.hillguava.xyz/llms.txt)