Carbonmark Holdings API
The Holdings API from Carbonmark — 2 operation(s) for holdings.
The Holdings API from Carbonmark — 2 operation(s) for holdings.
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-holdings-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 Holdings 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: Holdings
paths:
/holdings:
get:
summary: User Holdings
tags:
- Holdings
description: Get holdings for one or more wallet addresses
parameters:
- schema:
minItems: 1
type: array
items:
description: Wallet addresses to fetch holdings for
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
pattern: ^0x(?!0{40}$)[a-fA-F0-9]{40}$
type: string
in: query
name: addresses
required: true
description: One or more wallet addresses
- schema:
type: string
examples:
137-erc20-0x3c499c542cef5e3811e1192ce70d8cc03d5c3359:
value: 137-erc20-0x3c499c542cef5e3811e1192ce70d8cc03d5c3359
137-erc1155-0xd016B2AcECE65612B93cC9aeE763BDa0c2b0E4C0-1:
value: 137-erc1155-0xd016B2AcECE65612B93cC9aeE763BDa0c2b0E4C0-1
in: query
name: tokenIdentifier
required: false
description: Returns holdings concerning this token
- schema:
minimum: 0
type: number
example: '100'
in: query
name: minAmountTonnes
required: false
description: Only report amounts greater than the provided value (Tonnes)
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Holding'
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getHoldings
x-operation-id-source: derived
/holdings/{address}:
get:
summary: User Holdings
tags:
- Holdings
description: Get holdings for a specific wallet address
parameters:
- schema:
type: string
examples:
137-erc20-0x3c499c542cef5e3811e1192ce70d8cc03d5c3359:
value: 137-erc20-0x3c499c542cef5e3811e1192ce70d8cc03d5c3359
137-erc1155-0xd016B2AcECE65612B93cC9aeE763BDa0c2b0E4C0-1:
value: 137-erc1155-0xd016B2AcECE65612B93cC9aeE763BDa0c2b0E4C0-1
in: query
name: tokenIdentifier
required: false
description: Returns holdings concerning this token
- schema:
minimum: 0
type: number
example: '100'
in: query
name: minAmountTonnes
required: false
description: Only report amounts greater than the provided value (Tonnes)
- schema:
pattern: ^0x(?!0{40}$)[a-fA-F0-9]{40}$
type: string
example: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
in: path
name: address
required: true
description: The wallet address
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Holding'
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getHoldingsByAddress
x-operation-id-source: derived
components:
schemas:
Holding:
type: object
properties:
id:
type: string
walletAddress:
description: Blockchain address of the wallet that holds the tokens
type: string
token:
$ref: '#/components/schemas/Token'
amount:
type: number
batchId:
description: 'Base credits only: issuance batch, required by the base aggregator''s retireCredit call'
type: number
required:
- id
- walletAddress
- token
- amount
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.