# Vealth Carbon Retired Lookup (CDP-settled)

> Vealth Carbon Retired Lookup (CDP-settled) is a paid API for AI agents from vealth.net, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns verified tCO2e carbon retirement records for a given wallet address, sourced from Vealth's own CDP-settled retirement rail, with honest found:false when no record exists.

## Facts

- Endpoint: POST https://vealth.net/.well-known/vealth/cdp/carbon-retired
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vealth-carbon-retired-lookup-cdp-settled-1dd2ce9f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WrEOLqJqyGD-QzFYX63Pq

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 vealth-carbon-retired-lookup-cdp-settled-1dd2ce9f -d '<json body>'
```

Example prompt: Can you check how much carbon has been retired for wallet 0xABC123... and tell me if there's a verified tCO2e record on file — if nothing is found, just say so honestly.

## When to prefer this

Use this endpoint when you need to verify or audit carbon retirement records for a specific wallet address against Vealth's CDP-settled rail. Prefer this over generic carbon registry lookups when you specifically need CDP-settled mirror data with honest found:false semantics rather than ambiguous empty responses. Particularly useful for sustainability compliance checks, carbon accounting audits, or verifying on-chain climate commitments.

## Known failure modes

- Wallet not found — returns found:false rather than an error, indicating no retirement record exists
- Invalid wallet address format — likely a 4xx validation error
- Payment not received or x402 payment header missing — 402 Payment Required
- Upstream CDP settlement data unavailable — may return 5xx or stale data
- Rate limiting or quota exceeded — 429 error

## How this service works

Carbon Retired (CDP-settled mirror) — verified tCO2e retired through our rail, from our retirement records. Honest found:false when unknown.

## Output

A record containing the verified tCO2e amount retired through Vealth's CDP-settled rail for the given wallet, plus a found boolean (false if no retirement record exists for that wallet).

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vealth-carbon-retired-lookup-cdp-settled-1dd2ce9f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vealth.net](https://www.zero.xyz/host/vealth.net/llms.txt)