x402 Carbon Retirement API

Method	Path	Description	Cost
GET	/api/catalog	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.	$0.0011 default	View details

GET/api/catalog

$0.0011 default

Description

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.

Pricing

$0.0011 default

Parameters

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}

Example response

{
  "asOf": "2026-09-15T00:00:00.000Z",
  "catalogNote": "Prices are USDC per tonne before the 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. Either way the retirement costs the credit price plus a fee. GET discover returns the full catalog for free.",
  "classes": [
    {
      "carbonClassId": "0x0008f35758a4318942ecb5d5414116ce7b1ede2d",
      "category": "Wind Energy",
      "country": "India",
      "creditCount": 6,
      "liquidityTonnes": "228436",
      "name": "Wind Energy - Small Scale",
      "priceBasis": "indicative",
      "priceUsdcPerTonne": "40352",
      "priceUsdcPerTonneFormatted": "0.040352"
    },
    {
      "carbonClassId": "0x1ff9bd464155d32fd2f9d302008d38544c0ae371",
      "category": "Solar Energy",
      "country": "India",
      "creditCount": 13,
      "liquidityTonnes": "76646",
      "name": "Solar PV - Small Scale",
      "priceBasis": "indicative",
      "priceUsdcPerTonne": "16412",
      "priceUsdcPerTonneFormatted": "0.016412"
    },
    {
      "carbonClassId": "0xf4699531e0a5f6e9351a36de3753deaad329bf45",
      "category": "City Forest Credits",
      "country": "United States",
      "creditCount": 3,
      "liquidityTonnes": "6919",
      "name": "Regen Network - City Forest Credits",
      "priceBasis": "indicative",
      "priceUsdcPerTonne": "4449127",
      "priceUsdcPerTonneFormatted": "4.449127"
    }
  ],
  "endpoints": {
    "actionsRetire": {
      "method": "POST",
      "url": "https://x402.klimalabs.com/api/actions/retire"
    },
    "certificate": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/api/certificate"
    },
    "discover": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/api/discover"
    },
    "manifest": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/.well-known/x402.json"
    },
    "note": "Start here: every carbon retirement goes through these endpoints. discover, quote and certificate are free. Retiring is paid: each retirement costs the credit price plus a fee (and executor gas when relayed through actions/retire), sent from your own wallet via prepare/retire or authorized by signature via prepare-auth. Full request and response schemas: https://x402.klimalabs.com/openapi.json",
    "openapi": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/openapi.json"
    },
    "prepareAuth": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/api/prepare-auth"
    },
    "prepareRetire": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/api/prepare/retire"
    },
    "quote": {
      "method": "GET",
      "url": "https://x402.klimalabs.com/api/quote"
    }
  },
  "listings": [
    {
      "category": "Renewable Energy",
      "country": "Brazil",
      "creditId": "VCS-896-2011",
      "expiresAt": "2031-08-16T20:51:26.000Z",
      "leftToSellTonnes": "367811.2",
      "listingId": "0x06ae1ad6472fe406bfc6ec9d20f0060a90ae4911ba482f93fa4a6dceab5e40ca",
      "minFillTonnes": "0.001",
      "priceBasis": "firm",
      "priceUsdcPerTonne": "410000",
      "priceUsdcPerTonneFormatted": "0.41",
      "projectName": "Foz Do Chapecó Project",
      "registry": "VCS",
      "vintage": 2011
    },
    {
      "category": "Energy Efficiency",
      "country": "South Korea",
      "creditId": "VCS-1146-2015",
      "expiresAt": "2031-09-03T13:48:30.000Z",
      "leftToSellTonnes": "298147",
      "listingId": "0xea39b91a16003213b195a75476ea8277df1754309074437c9be72ae714ed1100",
      "minFillTonnes": "0.001",
      "priceBasis": "firm",
      "priceUsdcPerTonne": "730000",
      "priceUsdcPerTonneFormatted": "0.73",
      "projectName": "The Hyundai Waste Energy Recovery Co-Generation Project Phase II",
      "registry": "VCS",
      "vintage": 2015
    },
    {
      "category": "Renewable Energy",
      "country": "China",
      "creditId": "VCS-850-2016",
      "expiresAt": "2031-08-16T14:22:45.000Z",
      "leftToSellTonnes": "74959",
      "listingId": "0xd33885ac05bd66888963bab0b6b32248bcdc0501ce8152bafc854059b86d12e3",
      "minFillTonnes": "0.001",
      "priceBasis": "firm",
      "priceUsdcPerTonne": "520000",
      "priceUsdcPerTonneFormatted": "0.52",
      "projectName": "Inner Mongolia Jingneng Saihan Wind Farm Phase I Project",
      "registry": "VCS",
      "vintage": 2016
    }
  ]
}