# Vealth Carbon Credit Retirement (retire-attach)

> Vealth Carbon Credit Retirement (retire-attach) is a paid API for AI agents from vealth.net, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Retires a specified number of tonnes of carbon credits on-chain via Carbonmark and attaches the retirement proof to a beneficiary wallet address.

## Facts

- Endpoint: POST https://vealth.net/.well-known/vealth/retire-attach
- Price: $0.25/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-credit-retirement-retire-attach-0d264a1d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2nXcO2_49zipokMZ5PQ05

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-credit-retirement-retire-attach-0d264a1d -d '<json body>'
```

Example prompt: Retire 0.005 tonnes of carbon credits on-chain and attach the proof to my wallet address 0xYourAddress — I want a Basescan link and my Carbonmark retirement record.

## When to prefer this

Choose this endpoint when you need a fully on-chain, verifiable carbon credit retirement with a public transaction hash and a Carbonmark certificate URL attached to a specific beneficiary wallet. Prefer it over off-chain offset services when cryptographic proof of retirement is required for compliance, reporting, or audit trails. Ideal for agents that need to programmatically retire small fractional tonne amounts per user action or transaction.

## Known failure modes

- Insufficient USDC balance to cover the $0.25 call fee or carbon credit cost
- Invalid or malformed beneficiary_address (non-checksummed or non-EVM address)
- amount_tonnes too small or below minimum threshold for retirement
- Carbonmark or KlimaDAO liquidity unavailable for the requested amount
- Base chain congestion causing transaction timeout
- x402 payment protocol failure or incorrect payment header

## How this service works

Find useful work. Build a life from it. Every job shows the place, the task, the proof, and the pay before you begin. Start today and grow toward mastery.

## Output

Returns a JSON object confirming the retirement with: a boolean ok status, retire-attach version string, cost in USDC, the on-chain retirement transaction hash (retire_tx), a Basescan URL for the Base chain transaction, the amount retired in tonnes, the beneficiary address, and a Carbonmark retirements URL providing a publicly verifiable retirement certificate.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "amount_tonnes": {
   "type": "number"
  },
  "beneficiary_address": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "version": "retire-attach-v1",
  "cost_usdc": 0.15,
  "retire_tx": "0x…",
  "basescan_url": "https://basescan.org/tx/0x…",
  "amount_tonnes": 0.005,
  "beneficiary_address": "0xYourAddress",
  "carbonmark_retirements_url": "https://www.carbonmark.com/retirements/…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vealth-carbon-credit-retirement-retire-attach-0d264a1d/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)