{"uid":"cap_OdCTX9NOrKfdPdmbTKfRI","slug":"klima-retirement-aggregator-catalog-0b201dd2","name":"Klima Retirement Aggregator Catalog","description":"Live snapshot of the most liquid carbon credits retirable on Base: the top 3 Klima Protocol carbon classes and the top 3 Carbonmark marketplace listings, with USDC-per-tonne prices and tonnes available. Additionally, the additional endpoints to quote and retire carbon are included; query those endpoints for further discovery, quotes, and retirements. Query /.well-known, /openapi, and /discover to get started.","url":"https://x402-retire-git-feat-paid-indexing-gate-and-openapi-carbonmark.vercel.app/api/catalog?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["asOf","classes","listings","endpoints","note"],"properties":{"asOf":{"type":"string"},"note":{"type":"string"},"classes":{"type":"array","items":{"type":"object","required":["carbonClassId","name","category","country","priceUsdcPerTonne","priceUsdcPerTonneFormatted","priceBasis","liquidityTonnes","creditCount"],"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceBasis":{"type":"string","const":"indicative"},"creditCount":{"type":"number"},"carbonClassId":{"type":"string"},"liquidityTonnes":{"type":"string"},"priceUsdcPerTonne":{"type":"string"},"priceUsdcPerTonneFormatted":{"type":"string"}},"additionalProperties":false}},"listings":{"type":"array","items":{"type":"object","required":["listingId","projectName","creditId","registry","vintage","country","category","priceUsdcPerTonne","priceUsdcPerTonneFormatted","priceBasis","leftToSellTonnes","minFillTonnes","expiresAt"],"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"vintage":{"anyOf":[{"type":"number"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"creditId":{"anyOf":[{"type":"string"},{"type":"null"}]},"registry":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"listingId":{"type":"string"},"priceBasis":{"type":"string","const":"firm"},"projectName":{"anyOf":[{"type":"string"},{"type":"null"}]},"minFillTonnes":{"type":"string"},"leftToSellTonnes":{"type":"string"},"priceUsdcPerTonne":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceUsdcPerTonneFormatted":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"endpoints":{"type":"object","required":["discover","quote","prepareRetire","prepareAuth","actionsRetire","certificate","openapi"],"properties":{"quote":{"type":"string"},"openapi":{"type":"string"},"discover":{"type":"string"},"certificate":{"type":"string"},"prepareAuth":{"type":"string"},"actionsRetire":{"type":"string"},"prepareRetire":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8e8XS8RLWnVJ6tuOMjzee","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live snapshot of the top 3 most liquid Klima Protocol carbon credit classes and top 3 Carbonmark marketplace listings, including USDC-per-tonne prices and available tonnes for carbon retirement.","exampleAgentPrompt":"Show me the current carbon credit classes and marketplace listings available for retirement on Klima, with their USDC prices per tonne and how many tonnes are available.","exampleUseCases":[{"title":"Compare carbon credit prices before retiring","prompt":"What are the cheapest carbon credits I can retire right now on Klima? Show me the top listings with their USDC prices per tonne and how many tonnes are left to sell."},{"title":"Find high-liquidity carbon projects for offsetting","prompt":"I want to offset 50 tonnes of carbon — show me the most liquid Klima Protocol carbon classes available on Base with their current prices so I can pick the best one."},{"title":"Discover available carbon registries and vintages","prompt":"What carbon credit registries and project vintages are currently listed on Carbonmark for retirement? I need to see which ones are still active and what they cost per tonne."}],"resultDescription":"A JSON object with a timestamp (asOf), an array of up to 3 Klima Protocol carbon classes (each with carbonClassId, name, category, country, indicative USDC price per tonne, and liquidity in tonnes), an array of up to 3 Carbonmark marketplace listings (each with listingId, projectName, creditId, registry, vintage, country, category, firm USDC price per tonne, tonnes left to sell, minimum fill, and expiry), plus endpoint discovery links and a note.","failureModes":["No carbon classes or listings available if market liquidity is zero","Stale data if the indexer has not refreshed recently","Payment required error (402) if the x402 payment header is missing or invalid","Network timeout from upstream Klima or Carbonmark APIs","Truncated listings if fewer than 3 classes or listings are currently liquid"],"whenToPreferThis":"Use this endpoint when you need a real-time, pre-filtered snapshot of the most liquid and competitively priced carbon credits available for retirement on the Base blockchain via Klima Protocol or Carbonmark. Prefer this over building your own aggregation logic or querying Klima/Carbonmark APIs directly when you need a single unified view with USDC pricing ready for downstream quoting and retirement workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:35:50.361Z","isFirstParty":false,"canonicalSlug":"klima-retirement-aggregator-catalog-0b201dd2"}