Carbonmark Listing API
The Listing API from Carbonmark — 1 operation(s) for listing.
The Listing API from Carbonmark — 1 operation(s) for listing.
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-listing-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 Listing 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: Listing
paths:
/listings/{id}:
get:
summary: Listings
tags:
- Listing
description: Get a listing by its identifier
parameters:
- schema:
anyOf:
- type: string
enum:
- polygon
- type: string
enum:
- base
examples:
base:
value: base
polygon:
value: polygon
in: query
name: network
required: false
description: Marketplace network. Defaults to polygon.
- schema:
type: string
example: '0xde5c717958a9a80f2dee8ebcc6f411a8d860ac7b0042e45487f4ad2afaf46d5a'
in: path
name: id
required: true
description: The listing id
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Listing'
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getListingsById
x-operation-id-source: derived
components:
schemas:
Listing:
description: Marketplace listing with per-tonne price and project info.
type: object
properties:
id:
description: Unique listing identifier
type: string
leftToSell:
description: Remaining supply. Unformatted 18 decimal string
type: string
tokenAddress:
description: Address of the asset being sold
type: string
singleUnitPrice:
description: USDC.e price per tonne. Unformatted 6 decimal string. e.g. 1000000
type: string
totalAmountToSell:
type: string
active:
anyOf:
- type: boolean
- type: 'null'
deleted:
anyOf:
- type: boolean
- type: 'null'
createdAt:
anyOf:
- type: number
- type: 'null'
updatedAt:
anyOf:
- type: number
- type: 'null'
seller:
type: object
properties:
handle:
anyOf:
- type: string
- type: 'null'
username:
anyOf:
- type: string
- type: 'null'
description:
anyOf:
- type: string
- type: 'null'
profileImgUrl:
anyOf:
- type: string
- type: 'null'
id:
type: string
required:
- id
creditId:
description: Identifier of the credit related to this listing
type: string
expiration:
description: Unix Timestamp (seconds) when the listing expires.
type: number
minFillAmount:
description: Minimum quantity for purchase transaction to succeed.
type: string
project:
type: object
properties:
id:
type: string
key:
type: string
vintage:
type: string
name:
type: string
category:
type: string
country:
type: string
methodology:
type: string
isExAnte:
type: boolean
required:
- id
- key
- vintage
- name
- category
- country
- methodology
- isExAnte
token:
$ref: '#/components/schemas/Token'
required:
- id
- leftToSell
- tokenAddress
- singleUnitPrice
- totalAmountToSell
- seller
- creditId
- expiration
- minFillAmount
- project
- token
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
externalDocs:
url: https://docs.carbonmark.com/
description: Additional documentation. The complete product and platform knowledge base for Carbonmark can be found here.