# Invoket Climate Return Period API

> Invoket Climate Return Period API is a paid API for AI agents from api.invoket.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Ranks a season's temperature or rainfall against a location's ERA5 historical climate distribution, returning percentile, empirical return period, and sample size for risk and climate finance applications.

## Facts

- Endpoint: GET https://api.invoket.com/climate/return-period?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/invoket-climate-return-period-api-71b20f80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9bxnE3wBhGK9J_6frS3R5

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-return-period-api-71b20f80
```

Example prompt: For Paris (lat 48.85, lon 2.35), what percentile and return period was the 2022 summer mean temperature compared to ERA5 historical climate — and how many years of data is the estimate based on?

## When to prefer this

Use this endpoint when you need to quantify how extreme a specific year's season was relative to long-term ERA5 climate history at a location — particularly for parametric insurance triggers, reinsurance pricing, climate risk disclosure, or climate finance. Prefer this over anomaly endpoints when you need return-period framing (e.g. '1-in-20-year event') rather than just deviation from mean. No account or API key needed; pay per call via stablecoin.

## Known failure modes

- Invalid or out-of-range coordinates return an error (e.g. lat/lon outside ERA5 coverage)
- Unsupported season or variable type returns a validation error
- Target year outside ERA5 historical range returns no data
- Payment not settled via x402 results in 402 Payment Required response
- Missing required query parameters return a 400 Bad Request

## 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 the target year's seasonal climate value ranked within the ERA5 historical distribution for the location: a percentile (0–100), an empirical return period in years, and the sample size (number of historical seasons used). Useful for parametric insurance triggers, climate risk reports, and finance applications.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "lat",
  "lon",
  "year",
  "month"
 ],
 "properties": {
  "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"
  },
  "year": {
   "type": "string"
  },
  "month": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/invoket-climate-return-period-api-71b20f80/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)