# Orthogonal Cloud Cover Hourly API

> Orthogonal Cloud Cover Hourly 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 hourly cloud cover fraction (0–1 scale) for one or more geographic coordinates over a specified date range

## Facts

- Endpoint: GET https://x402.orthogonal.com/precip/api/v1/cloud-cover-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-cloud-cover-hourly-api-85db2d55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yVjC5qdBbM1v6vb2c5ujv

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-cloud-cover-hourly-api-85db2d55
```

Example prompt: Can you get me the hourly cloud cover forecast for San Francisco (37.7575, -122.42616) from October 1 to October 31, 2025, in the America/Los_Angeles timezone?

## When to prefer this

Choose this endpoint when you need sub-daily (hourly) cloud cover resolution for specific geographic coordinates, especially for use cases like solar energy modeling, astronomy/stargazing planning, photography scheduling, or any application that requires knowing sky conditions at a precise time and place. It supports multiple locations in a single call and flexible output formats (JSON, GeoJSON, CSV), making it efficient for batch geospatial workflows. Prefer this over daily weather summary APIs when hourly granularity of sky opacity is critical.

## Known failure modes

- Missing or malformed latitude/longitude values return a 400 error
- Date range outside available historical or forecast data window returns empty or error
- Invalid IANA timezone identifier causes request failure
- Mismatched number of latitude and longitude values causes a parsing error
- Payment failure or insufficient USDC balance returns a 402 error
- Requesting too many coordinate pairs may exceed payload or rate limits

## How this service works

Hourly cloud cover fraction (0-1, where 0 is clear and 1 is overcast) | ERROR: Unable to calculate price.

## Output

Returns a time series of hourly cloud cover fraction values (0.0 = fully clear sky, 1.0 = fully overcast) for each submitted coordinate pair, indexed by local timestamp according to the specified IANA timezone. Output is available in JSON, GeoJSON, or CSV format and can cover multiple locations in a single response.

## 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": "2025-10-31",
       "example": "2025-10-31"
      },
      "start": {
       "type": "string",
       "default": "2025-10-01",
       "example": "2025-10-01"
      },
      "format": {
       "type": "string",
       "default": "json",
       "description": "Output format: `geojson`, `json` or `csv`"
      },
      "latitude": {
       "type": "string",
       "default": "37.75750,42.35355,29.97991",
       "example": "37.75750,42.35355,29.97991",
       "description": "Comma-separated list of latitude coordinates (WGS84)"
      },
      "longitude": {
       "type": "string",
       "default": "-122.42616,-71.06053,-90.07447",
       "example": "-122.42616,-71.06053,-90.07447",
       "description": "Comma-separated list of longitude coordinates (WGS84)"
      },
      "timeZoneId": {
       "type": "string",
       "default": "America/Chicago",
       "example": "America/Chicago",
       "description": "IANA timezone identifier for localizing timestamps"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orthogonal-cloud-cover-hourly-api-85db2d55/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)