# India Data Gateway – Monsoon Onset by State

> India Data Gateway – Monsoon Onset by State is a paid API for AI agents from gateway.hillguava.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-08).

Returns the IMD-sourced monsoon onset and withdrawal status for a specified Indian state, including normal onset date, normal withdrawal date, and current season bulletin status.

## Facts

- Endpoint: GET https://gateway.hillguava.xyz/weather/monsoon/onset/%7Bstate%7D
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/india-data-gateway-monsoon-onset-by-state-96bc53c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xZhLchxQZbeLwMICwF8zN

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-data-gateway-monsoon-onset-by-state-96bc53c4
```

Example prompt: When does the monsoon typically arrive and withdraw in Kerala, and what does the latest IMD bulletin say about the current season's onset status?

## When to prefer this

Use this endpoint when you need structured, per-state monsoon onset and withdrawal data for India, particularly IMD-aligned normal dates and current season bulletin status. Prefer this over generic weather APIs when the query is specifically about Indian monsoon seasonality rather than day-to-day forecasts. It requires no API key — only a USDC micropayment via x402 on Base.

## Known failure modes

- Invalid or misspelled state name returns an error or empty response
- State not recognized in IMD dataset returns null or error
- IMD bulletin not yet published for the current season returns a stale or empty status field
- Payment not completed (x402 flow incomplete) returns 402 Payment Required
- Gateway downtime or upstream IMD data unavailability returns 5xx error

## How this service works

The India data layer for AI agents. Pay only for the calls you make — no API keys, no accounts, no minimums, no rate limits. One x402 origin covering Indian weather (forecasts, monsoon), markets (stocks, indices, F&O with Black-Scholes Greeks, historical, mutual funds), RBI macro, identity/format verification (IFSC, pincode, GSTIN), NSE market holidays, panchang (Hindu almanac), and live cricket scores. Settle per call in USDC on Base.

## Output

A JSON object containing the state name, current season year, IMD bulletin-based onset status (e.g. 'Likely active/mentioned in latest IMD bulletin'), the normal onset date (e.g. 'June 01'), and the normal withdrawal date (e.g. 'October 31').

## 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-data-gateway-monsoon-onset-by-state-96bc53c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.hillguava.xyz](https://www.zero.xyz/host/gateway.hillguava.xyz/llms.txt)