# Orthogonal Hourly Near-Surface Air Temperature API

> Orthogonal Hourly Near-Surface Air Temperature 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-16).

Returns hourly near-surface air temperature in Celsius for one or more geographic coordinates over a specified date range

## Facts

- Endpoint: GET https://x402.orthogonal.com/precip/api/v1/temperature-hourly
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orthogonal-hourly-near-surface-air-temperature-api-b6ad48be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gNxhuM9QopTLkQOE8NKO1

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-near-surface-air-temperature-api-b6ad48be
```

Example prompt: Can you get me the hourly air temperature in Celsius for San Francisco (37.7575, -122.42616) and Boston (42.35355, -71.06053) from June 1 to June 30, 2025, localized to America/Chicago time, in JSON format?

## When to prefer this

Choose this endpoint when you need hourly granularity of near-surface air temperature in Celsius for one or multiple specific geographic coordinates over a custom date range. It is especially useful for bulk multi-location queries, supporting output in GeoJSON for geospatial tools or CSV for data analysis pipelines. Prefer it over general weather APIs when you need programmatic, structured climate data with timezone localization and pay-per-call pricing via x402.

## Known failure modes

- Invalid or out-of-range latitude/longitude coordinates returns an error
- Malformed date format (non-ISO) causes a bad request response
- Unsupported timezone identifier causes a parsing or lookup error
- Date range too large may result in timeout or oversized response
- Missing required query parameters results in a 400 error
- Payment failure or insufficient USDC balance results in 402 Payment Required

## How this service works

Hourly near-surface air temperature in Celsius (°C) | ERROR: Unable to calculate price.

## Output

Returns hourly near-surface air temperature values in Celsius for each requested coordinate, timestamped and localized to the specified IANA timezone. Output is available in JSON, GeoJSON, or CSV format, covering every hour within the requested date range for each lat/lon pair provided.

## 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-06-30",
       "example": "2025-06-30"
      },
      "start": {
       "type": "string",
       "default": "2025-06-01",
       "example": "2025-06-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-hourly-near-surface-air-temperature-api-b6ad48be/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)