← UnyKorn Carbon · Services · Tools · Registry check

UnyKorn Carbon · Agents

Carbon agents that other software can find, pay and check

8 agents over International Carbon Registry (ICR) records. Each has one job, a published identity file in the ERC-8004 format, a free route for people, and a pay-per-call route for software over x402. None of them can move, issue or retire a credit.

How a software agent pays

  1. Call a paid route with no payment. The reply is 402 Payment Required with the price, network, token and receiving address in the PAYMENT-REQUIRED header and the body.
  2. Sign a USDC transfer authorization for that amount (EIP-3009) and call again with it in the PAYMENT-SIGNATURE header.
  3. The payment is verified, the work is done, the payment is settled, and the answer comes back with the transaction in the PAYMENT-RESPONSE header.

A failed request is never charged: settlement happens only after the answer is ready. Standard x402 version 2 clients work unchanged.

Payment discovery
/.well-known/x402
Identity file
/.well-known/agent-registration.json
OpenAPI
/openapi.json
Identity registry
eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Network
Base Sepolia (test network, no real money) (eip155:84532)
Receiving address
0x7d9a65d06dcc435a52D5880C6310Bd6E96c156DB

Registry Reader

Live Free route$0.02 per paid call

One ICR project's public record, read straight from its contract on Polygon.

Read-only. Cannot move, issue or retire a credit, and holds no key.

Free route
GET /api/icr/project
Paid route (x402)
GET /x402/icr/project
Inputs
address: Project contract address on Polygon
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/icr/project?address=0x3c1dec203457334d134f9013fee53776bd40149d"

Retirement Verifier

Live, beta Free route$0.05 per paid call

Whether a retirement certificate is real, for how many tonnes, and in whose name.

Read-only. Cannot move, issue or retire a credit, and holds no key.

Free route
GET /api/icr/retirement
Paid route (x402)
GET /x402/icr/retirement
Inputs
address: Project contract address on Polygon
certificate: Retirement certificate number
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/icr/retirement?address=0x3c1dec203457334d134f9013fee53776bd40149d&certificate=1"

Project Screener

Live Free route$0.10 per paid call

A first-pass screen of a project idea: likely sector, methodology routes, red flags.

Read-only. Cannot move, issue or retire a credit, and holds no key.

Free route
GET /api/carbon/screen
Paid route (x402)
GET /x402/carbon/screen
Inputs
description: What the project does, where, and who owns the site
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/carbon/screen?description=reforestation%20of%202%2C000%20hectares%20on%20leased%20land%20in%20Kenya"

Fee Estimator

Live Free route$0.02 per paid call

What ICR will charge for a project of a given size, from ICR's published fee schedule.

Read-only. Cannot move, issue or retire a credit, and holds no key.

Free route
GET /api/carbon/fees
Paid route (x402)
GET /x402/carbon/fees
Inputs
tonnes: Credits expected per year
price: Expected price per tonne in USD
kind (optional): "expost" (default) or "exante"
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/carbon/fees?tonnes=10000&price=5"

Retirement Preparer

Live, beta Free route$0.05 per paid call

The exact transaction and message a credit holder must sign to retire on ICR, built to ICR's documented steps.

Prepares only. The credit holder signs and sends; this agent holds no key and retires nothing.

Free route
GET /api/icr/prepare-retirement
Paid route (x402)
GET /x402/icr/prepare-retirement
Inputs
project: Project contract address on Polygon
vintageTokenId: Token id of the vintage to retire from
tonnes: Tonnes to retire
beneficiaryAddress: Wallet that receives the certificate
beneficiaryName: Name shown on the certificate
reason: One of the reasons ICR accepts
comment (optional): Comment stored on the certificate
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/icr/prepare-retirement?project=0x3c1dec203457334d134f9013fee53776bd40149d&vintageTokenId=1&tonnes=10&beneficiaryAddress=0x0000000000000000000000000000000000000001&beneficiaryName=Acme%20Corp&reason=Voluntary%20purposes"

Global Market Snapshot

Live Free route$0.05 per paid call

Live carbon ETF benchmarks, Base Mainnet Klima x402 liquidity, Polygon Carbonmark listings, and verified ICR Polygon census totals.

Read-only. Cannot move, issue or retire a credit, and holds no key.

Free route
GET /api/markets/overview
Paid route (x402)
GET /x402/markets/overview
Inputs
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/markets/overview?"

50-Route Verifier

Live Free route$0.05 per paid call

Queries 50 primary-source verified carbon issuance, venue, government grant, bond, and Paris Article 6 routes with citations.

Read-only. Cannot move, issue or retire a credit, and holds no key.

Free route
GET /api/markets/routes
Paid route (x402)
GET /x402/markets/routes
Inputs
track (optional): Track filter: Issue, Sell, Venue, Wrap, Gov, Finance, Global
status (optional): Status filter: confirmed, partly, wrong, unverified
icr (optional): ICR acceptance filter: yes, no, unknown
q (optional): Keyword search across route name, summary, and caution
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/markets/routes?"

Base x402 Quote Preparer

Live Free route$0.05 per paid call

Fetches a direct 0%-UnyKorn-cut Base Mainnet USDC retirement quote and unsigned calldata from KlimaLabs x402.

Prepares only with 0% UnyKorn cut. Holds no key, custodies no funds, and sends no transaction.

Free route
GET /api/markets/quote
Paid route (x402)
GET /x402/markets/quote
Inputs
listingId (optional): Base marketplace listingId (bytes32) from /api/markets/overview
carbonClass (optional): Klima Protocol carbonClass address (0x...) from /api/markets/overview
tonnes (optional): Tonnes to quote (default 100)
ERC-8004 identity
Not yet registered on chain. The registration file is published and ready. Registration file

Try it

curl "https://carbon.unykorn.ai/api/markets/quote?"

UnyKorn LLC (Wyoming) is not affiliated with or endorsed by ICR. These agents read public records and published documents and report what they find. Nothing here is an audit, a valuation, an eligibility decision or advice.