Carbonmark Prices API
The Prices API from Carbonmark — 1 operation(s) for prices.
The Prices API from Carbonmark — 1 operation(s) for prices.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/carbonmark-com:carbonmark-com-prices-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Carbonmark REST Prices API
license:
name: Proprietary
description: 'Welcome to the API Reference docs for **version v20** of the Carbonmark REST API.
Use this API to view assets, prices, supply, activity and more.
To find the latest stable version, visit docs.carbonmark.com.
## Quick start
Be sure to prefix a version number, otherwise your application will be exposed to breaking changes.
~~~ts
const res = await fetch("https://v20.api.carbonmark.com/projects");
const projects = await res.json();
~~~
For a developer guides and example implementations, or to learn more about Carbonmark and the Carbon Market, view our product knowledge base at docs.carbonmark.com.
##'
termsOfService: https://www.carbonmark.com/terms-of-use
contact:
name: Support
url: https://www.carbonmark.com/contact-us
version: v20
servers:
- url: https://v20.api.carbonmark.com
tags:
- name: Prices
paths:
/prices:
get:
summary: List asset prices
tags:
- Prices
description: Retrieve a list of listing prices created by sellers.
parameters:
- schema:
type: string
example: '1620000000'
in: query
name: expiresAfter
required: false
description: Only return projects listings that expire after this timestamp (Unix seconds)
- schema:
type: array
items:
description: Desired IDs of the related projects.
examples:
- VCS-191
type: string
in: query
name: projectIds
required: false
- schema:
type: array
items:
description: Desired listing ids
examples:
- '0x7eee78739d79f7a2ac9f995f7d3e96e4abb453125d0f2283ac5eba3b6d05199e'
type: string
in: query
name: listingIds
required: false
- schema:
minimum: 0
type: number
example: '100'
in: query
name: minSupply
required: false
description: Only return projects with a purchaseable supply greater than this amount (Tonnes)
- schema:
type: array
items:
type: string
in: query
name: vintage
required: false
description: Desired vintages of carbon projects
- schema:
type: array
items:
type: string
in: query
name: assetPriceSourceIds
required: false
description: Filter prices matching specific asset_price_source_ids
- schema:
minimum: 0
type: number
example: '100'
in: query
name: minPriceUSD
required: false
description: Minimum price in USD
- schema:
type: array
items:
description: Filter prices matching specific asset price types
anyOf:
- title: listing
type: string
enum:
- listing
- title: klimaprotocol
type: string
enum:
- klimaprotocol
example:
- listing
- klimaprotocol
in: query
name: assetPriceType
required: false
responses:
'200':
description: List of prices
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/AssetPrice'
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getPrices
x-operation-id-source: derived
components:
schemas:
CarbonCreditId:
type: object
properties:
vintage:
description: Vintage of the carbon credit
type: number
projectId:
description: ID of the project associated with this credit
type: string
creditId:
description: ID of the credit
type: string
required:
- vintage
- projectId
Token:
type: object
properties:
id:
description: Identifier of the token
type: string
address:
description: Address of the credit being sold
type: string
decimals:
description: 'The smallest divisible unit for the token '
type: number
tokenId:
anyOf:
- description: ID of the credit being sold (0 for ERC20 tokens)
type: number
- type: 'null'
tokenStandard:
description: Standard of the Token
anyOf:
- title: erc20
type: string
enum:
- erc20
- title: erc1155
type: string
enum:
- erc1155
name:
description: Name of the token.
type: string
isExAnte:
description: Ex-ante credits refer to those that are issued on the basis of predicted or expected future carbon emissions reductions or removals.
type: boolean
symbol:
description: Symbol of the token
type: string
creditTokenId:
description: Unique identifier for this token
type: string
required:
- id
- address
- decimals
- tokenStandard
- name
- isExAnte
- symbol
- creditTokenId
AssetPrice:
type: object
properties:
sourceId:
description: Unique identifier for this price source. Provide this id when generating a Quote.
type: string
example: listing-137-0x886289a280cd265093215ff2893c29ff24c1381e830f63b0c71a335a7f15b362
type:
description: Type of the asset price
anyOf:
- title: listing
description: Marketplace listing
type: string
enum:
- listing
- title: klimaprotocol
description: Klima Protocol
type: string
enum:
- klimaprotocol
example: listing
purchasePrice:
description: Quoted price to retire 1 tonne of this asset.
type: number
baseUnitPrice:
description: Value of the asset set by the seller for listing or raw redemption cost for carbon pools.
type: number
supply:
description: Total supply of carbon tokens in the listing or pool. For carbon pools, some of this may be illiquid. Use liquidSupply instead.
type: number
liquidSupply:
description: Amount of carbon available for retirement. For carbon pools, this value excludes the illiquid supply.
type: number
minFillAmount:
description: Minimum required quantity for transactions.
type: number
settlementToken:
description: Token used to settle purchases for this asset price.
anyOf:
- title: kvcm
description: KVCM token used for settlement (Klima Protocol on Base).
type: string
enum:
- kvcm
- title: usdc
description: USDC used for settlement.
type: string
enum:
- usdc
example: usdc
listing:
description: Listing specific metadata
type: object
properties:
id:
type: string
creditId:
$ref: '#/components/schemas/CarbonCreditId'
token:
$ref: '#/components/schemas/Token'
sellerId:
description: Wallet address of the user who created the listing.
type: string
expiresAfter:
description: Timestamp when this price automatically expires
type: number
required:
- id
- creditId
- token
- sellerId
- expiresAfter
klimaprotocol:
description: Listing specific metadata
type: object
properties:
creditId:
$ref: '#/components/schemas/CarbonCreditId'
token:
$ref: '#/components/schemas/Token'
carbonClass:
type: object
properties:
id:
type: string
required:
- id
required:
- creditId
- token
- carbonClass
required:
- sourceId
- type
- purchasePrice
- baseUnitPrice
- supply
- liquidSupply
- minFillAmount
- settlementToken
externalDocs:
url: https://docs.carbonmark.com/
description: Additional documentation. The complete product and platform knowledge base for Carbonmark can be found here.