Vealth · API contract
Discover, price, pay, receive, verify, escalate. One input (address, kitchen, site, or bundle) becomes one verifiable JSON artifact. The live paid execution surface is x402 on Base. Aggregator-style quote/order/retire behavior is the direction, not yet a live capability.
What this is. A set of paid x402 endpoints that turn one input into one verifiable JSON artifact, plus the discovery and proof surfaces an autonomous agent needs to use them without operator intervention.
What this is not. Not a Carbonmark API. Not a Klima integration. The legacy retire path is archived and pulse-only by design (retire_tx: null); the only canonical onchain retire here is build-eco-food-retire ($0.04), verified only when both child transactions (wind + solar) land on Base with non-placeholder tx hashes.
No PMF, customer revenue, measured ecological impact, or official LBC / Michelin Guide / UN / SDG / government endorsement claimed. external_buyers_count: 0. Single source of truth: first-external-buyer-watch.json.
An agent can map the entire surface from static, public, auditable files, before signing a single transaction.
quality field meansPrices are static per endpoint and exposed in the manifest (priceUsd) and catalog. There is no /quote endpoint. Closest pricing helpers already live: ai-retire-bundler ($0.001, kWh + CO2e per workload, the cheapest call in the catalog), regen-retirement-builder ($0.02, a min-cost fill plan that does not retire), and regen-class-momentum ($0.006).
POST the endpoint with an x402 authorization header. Settlement is USDC on Base to 0x538aa4800ae2bd8e90556899514376ab96113a8e.
POST https://vealth.net/.well-known/vealth/<product>
X-PAYMENT: <base64 signed USDC authorization (standard x402 exact scheme)>
Content-Type: application/json
{ ...input object per product fixture... }
Want to test wiring before signing real EIP-3009? An operator-issued X-API-KEY bypass exists for wiring tests against the real response shape. A bypass call does NOT flip external_buyers_count.
Every paid response carries an artifact_url (human page) and artifact_id; bundles also carry result.artifact_api so an agent can continue programmatically. What to do next is encoded in real fields, not guessed: decisionSummary.one_liner, topActions[] (with who / when / why), gaps[], and quality.approval_gates[].
build-eco-food-retire only): per-child Base tx URLs on the responseEvery paid response surfaces an explicit quality.approval_gates[] array with action, authority, and why. L0–L2 is safe, bounded, autonomous (the paid call itself). L3 is operator-paced (supplier outreach, registry submission, public claims). L4 is irreversible (capital movement, retirement broadcast off the canonical path, treasury action).
If your agent hits an L3 or L4 gate that matters for your use case, email [email protected]. Human escalation is one mailto away; the autonomous loop is not broken.
quality block: lbc-scan, michelin-score, sdg-assess, build-eco-food, build-eco-food-retire, michelin-gap-analyzer, regen-reputation, regen-class-momentum, regen-retirement-builder, nrel-solar-yield-batch, ai-retire-bundler.build-eco-food-retire (two-child wind + solar)./quote with real-time price + inventory across a sell-order index./order + multi-credit-class retire planning.external_buyers_count > 0).