# Invoket Climate Degree-Days API

> Invoket Climate Degree-Days API is a paid API for AI agents from api.invoket.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns heating, cooling, and growing degree-days for any location over a specified date range, computed from ERA5 reanalysis daily mean temperature data.

## Facts

- Endpoint: POST https://api.invoket.com/climate/degree-days
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/invoket-climate-degree-days-api-d6b7669c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AhIxVwht82Tg9vd-3lX1m

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 invoket-climate-degree-days-api-d6b7669c -d '<json body>'
```

Example prompt: What were the heating, cooling, and growing degree-days for Paris (48.85°N, 2.35°E) from January 1 to March 31, 2024?

## When to prefer this

Choose this endpoint when you need historically grounded, high-quality degree-day computations (HDD, CDD, GDD) from ERA5 reanalysis data for any global location without managing API keys or subscriptions — ideal for energy audits, building performance modeling, agricultural planning, or climate analytics pipelines requiring pay-per-call simplicity.

## Known failure modes

- Invalid or out-of-range coordinates return an error
- Date range outside ERA5 coverage (pre-1940) returns an error
- Malformed date format causes a 400 Bad Request
- Network or upstream ERA5 data unavailability may cause timeouts
- Payment not settled via x402 returns a 402 Payment Required

## How this service works

The checks your agent runs before it acts: verify a bank account, a phone number, a law in force, the weather or a vehicle — computed from official sources, with provenance in every response. You only pay for answers.

## Output

Returns structured degree-day values (heating, cooling, growing) for the requested location and date range, derived from ERA5 reanalysis daily mean temperature data decoded from GRIB format. Suitable for energy demand estimation and crop growth modeling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "to",
  "lat",
  "lon",
  "base",
  "from",
  "kind"
 ],
 "properties": {
  "to": {
   "type": "string"
  },
  "lat": {
   "type": "string",
   "description": "Latitude in decimal degrees. Alternative: pass city=<name> (alias location=, optional country= ISO 3166 alpha-2) instead of lat+lon — resolved via the embedded GeoNames gazetteer (exact match, most populous wins) and echoed back as data.location"
  },
  "lon": {
   "type": "string"
  },
  "base": {
   "type": "string"
  },
  "from": {
   "type": "string"
  },
  "kind": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/invoket-climate-degree-days-api-d6b7669c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.invoket.com](https://www.zero.xyz/host/api.invoket.com/llms.txt)