# Orthogonal Hourly Precipitation API

> Orthogonal Hourly Precipitation API is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns comprehensive hourly precipitation data (amount, type, probability, source) for one or more locations, seamlessly blending historical observations and forecast data over a requested time range.

## Facts

- Endpoint: GET https://x402.orthogonal.com/precip/api/v1/hourly
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orthogonal-hourly-precipitation-api-d5ead97c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ff6tY1NKX9e1_Kukg9P9G

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 orthogonal-hourly-precipitation-api-d5ead97c
```

Example prompt: Can you get me hourly precipitation data for San Francisco (latitude 37.7575, longitude -122.42616) from January 4 to February 4, 2024, in the America/Los_Angeles timezone? I need to know the rain amounts, types, and probabilities for each hour.

## When to prefer this

Choose this endpoint when you need hour-by-hour precipitation detail (not just daily summaries) and especially when your time range spans both past and future — it automatically blends historical observations with forecast data so you don't need two separate API calls. It also supports querying multiple geographic coordinates in a single request, making it efficient for multi-location workflows. Prefer this over general weather APIs when precipitation specifics (amount, type, probability) are the primary data need.

## Known failure modes

- Missing required latitude or longitude parameters returns a 400 error
- Malformed date strings for start or end cause a 400 validation error
- Requesting an extremely long date range may result in timeout or truncated data
- Invalid timezone ID returns an error or falls back to UTC
- Mismatched number of latitude and longitude values causes a parameter error
- Payment failure via x402 protocol prevents access to data

## How this service works

Returns comprehensive hourly precipitation data for the given time range and location(s). Each hour includes precipitation amount, type (rain/snow/mixed), probability (for forecasts), and data source. Seamlessly combines historical observations with forecast data depending on the requested time range. | ERROR: Unable to calculate price.

## Output

A structured JSON response with hourly records for each requested location, where each record includes the hour timestamp, precipitation amount (in mm or inches), precipitation type (rain, snow, or mixed), probability (percentage, for forecast hours), and the data source (historical observation vs. forecast model). Multiple locations are returned in parallel arrays corresponding to the input lat/lon pairs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "string",
       "default": "2024-02-04",
       "example": "2024-02-04"
      },
      "start": {
       "type": "string",
       "default": "2024-01-04",
       "example": "2024-01-04"
      },
      "format": {
       "type": "string",
       "default": "json"
      },
      "latitude": {
       "type": "string",
       "default": "37.75750,42.35355,29.97991",
       "example": "37.75750,42.35355,29.97991"
      },
      "longitude": {
       "type": "string",
       "default": "-122.42616,-71.06053,-90.07447",
       "example": "-122.42616,-71.06053,-90.07447"
      },
      "timeZoneId": {
       "type": "string",
       "default": "America/Chicago"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orthogonal-hourly-precipitation-api-d5ead97c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)