# Vealth Regen Retirement Builder

> Vealth Regen Retirement Builder is a paid API for AI agents from vealth.net, paid per call via x402, $0.02/call, status down (last checked 2026-09-15).

Builds a carbon credit retirement portfolio from Regen Network by matching vintage, tonnage, and budget constraints to available ecological credits.

## Facts

- Endpoint: POST https://vealth.net/.well-known/vealth/regen-retirement-builder
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vealth-regen-retirement-builder-ab4fea26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0xS6zFO9tMuFhRYOY_zFJ

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-regen-retirement-builder-ab4fea26 -d '<json body>'
```

Example prompt: Can you build me a Regen carbon credit retirement plan targeting at least 10 tonnes of CO2 from credits with a 2020 or newer vintage, keeping the total spend under $200?

## When to prefer this

Use this endpoint when you need to programmatically source and plan carbon credit retirements from Regen Network with explicit vintage, tonnage, and budget controls. Prefer this over generic carbon market APIs when you need Regen Ledger-native credit classes with direct marketplace order links and per-credit pricing breakdowns.

## Known failure modes

- Budget too low to meet target tonnage — returns partial or empty lines array
- No credits available matching the specified minimum vintage — empty result set
- Invalid or negative values for min_vintage, target_tonnes, or max_budget_usd — likely 400 error
- Regen Network upstream unavailability — service may return 5xx or stale data
- Budget constraint met before reaching target_tonnes — partial allocation returned

## 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 list of credit line items each with cost in USD, tonnes covered, credit class ID, order ID, and a direct Regen Network marketplace URL, plus totals for USD spent, tonnes retired, and average price per credit across the portfolio.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lines": [
   {
    "usd": 87.75,
    "tonnes": 6.5,
    "class_id": "C01",
    "order_id": "1234",
    "marketplace_url": "https://app.regen.network/storefront/1234"
   },
   {
    "usd": 56,
    "tonnes": 3.5,
    "class_id": "C02",
    "order_id": "1289",
    "marketplace_url": "https://app.regen.network/storefront/1289"
   }
  ],
  "total_usd": 143.75,
  "total_tonnes": 10,
  "avg_per_credit": 14.375
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vealth-regen-retirement-builder-ab4fea26/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)