# Klima Retirement Aggregator Catalog

> Klima Retirement Aggregator Catalog is a paid API for AI agents from x402.klimalabs.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-18).

Fetches a real-time snapshot of the most liquid tokenized carbon credit supply available for retirement on Base via Klima Protocol and Carbonmark, including classes, listings, prices, and endpoint discovery.

## Facts

- Endpoint: GET https://x402.klimalabs.com/api/catalog?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/klima-retirement-aggregator-catalog-d19f4625
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mkb2f9bh8WYGyRsZivgRD

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 klima-retirement-aggregator-catalog-d19f4625
```

Example prompt: Show me the current catalog of tokenized carbon credits available to retire on Klima Protocol — I want to see what classes and listings are available and their USDC prices per tonne so I can pick which ones to offset with.

## When to prefer this

Use this endpoint when you need a quick, authoritative snapshot of currently available tokenized carbon credit supply on Base (Klima Protocol / Carbonmark) — including prices and endpoint discovery — before committing to a retirement transaction. Prefer this over the free /api/discover endpoint when you specifically want the most liquid supply curated snapshot rather than the full catalog; it costs $0.001 USDC but is optimized for liquid listings.

## Known failure modes

- Payment of $0.001 USDC not fulfilled — returns 402 Payment Required
- Catalog temporarily unavailable due to on-chain data lag — may return stale or empty classes/listings arrays
- Invalid x402 payment header — returns 402 with payment requirements
- Network timeout fetching live on-chain supply data

## How this service works

Entry point to the x402 Carbon Retirement API on Base. Returns every endpoint you need plus a live snapshot of the top 3 carbon classes and marketplace listings by liquidity. Discover, quote and certificate are free. Retiring is paid: each retirement costs the credit price plus a fee, sent from your own wallet (prepare/retire) or relayed from a signed USDC authorization (prepare-auth + POST actions/retire). Full spec at /openapi.json.

## Output

A JSON snapshot containing a timestamp (asOf), an array of carbon credit classes with indicative live prices in USDC per tonne, an array of firm-ask seller listings, and a directory of all retirement-related endpoints (discover, quote, prepare/retire, prepare-auth, actions/retire, certificate, openapi) with notes on which are free vs. paid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-09-15T00:00:00.000Z",
  "classes": [],
  "listings": [],
  "endpoints": {
   "note": "Start here: every carbon retirement goes through these endpoints. discover, quote, prepare/retire, prepare-auth and certificate are free to call. Retiring pays the credit price plus the on-chain protocol fee (and executor gas when relayed through actions/retire), funded by your wallet or signed authorization. Full request and response schemas: https://x402.klimalabs.com/openapi.json",
   "quote": {
    "url": "https://x402.klimalabs.com/api/quote",
    "method": "GET"
   },
   "openapi": {
    "url": "https://x402.klimalabs.com/openapi.json",
    "method": "GET"
   },
   "discover": {
    "url": "https://x402.klimalabs.com/api/discover",
    "method": "GET"
   },
   "manifest": {
    "url": "https://x402.klimalabs.com/.well-known/x402.json",
    "method": "GET"
   },
   "certificate": {
    "url": "https://x402.klimalabs.com/api/certificate",
    "method": "GET"
   },
   "prepareAuth": {
    "url": "https://x402.klimalabs.com/api/prepare-auth",
    "method": "GET"
   },
   "actionsRetire": {
    "url": "https://x402.klimalabs.com/api/actions/retire",
    "method": "POST"
   },
   "prepareRetire": {
    "url": "https://x402.klimalabs.com/api/prepare/retire",
    "method": "GET"
   }
  },
  "catalogNote": "Prices are USDC per tonne before the on-chain protocol fee. Class prices are indicative live quotes; listing prices are the seller's firm ask. To retire: GET quote, then either GET prepare/retire and send the transactions from your own wallet, or GET prepare-auth, sign its typedData and POST actions/retire. None of those charge an API fee. GET discover returns the full catalog for free."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/klima-retirement-aggregator-catalog-d19f4625/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.klimalabs.com](https://www.zero.xyz/host/x402.klimalabs.com/llms.txt)