Carbonmark Wallets API
The Wallets API from Carbonmark — 4 operation(s) for wallets.
The Wallets API from Carbonmark — 4 operation(s) for wallets.
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-wallets-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 Wallets 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: Wallets
paths:
/wallets:
post:
summary: Create a team wallet
tags:
- Wallets
requestBody:
content:
application/json:
schema:
type: object
properties: {}
parameters:
- schema:
anyOf:
- description: UUID of the team
examples:
- 79875d4d-4b7c-4b72-99e5-19955172d7d1
type: string
- description: Handle of the team or 'default' for the default team of the connected user
examples:
- handle
type: string
in: query
name: team
required: true
- schema:
type: string
example: Bearer cm_api_d286bc5a-9980-43b7-9507-7fc013fecca8
in: header
name: Authorization
required: true
description: Bearer token
responses:
'200':
description: Default Response
content:
application/json:
schema:
$ref: '#/components/schemas/Challenge'
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: postWallets
x-operation-id-source: derived
/wallets/{uuid}:
get:
summary: Get a wallet information
tags:
- Wallets
parameters:
- schema:
type: string
in: path
name: uuid
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
$ref: '#/components/schemas/Wallet'
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getWalletsByUuid
x-operation-id-source: derived
/wallets/{uuid}/allowances:
get:
summary: Get wallet allowances for the given holdings
tags:
- Wallets
parameters:
- schema:
type: string
example: 137-ERC20-0x314c0a010e148f1e1286f96f78ed366255267d54
in: query
name: tokenIdentifier
required: true
description: Identifier of the token
- schema:
type: string
example: '0x8cE54d9625371fb2a068986d32C85De8E6e995f8'
in: query
name: spenderAddress
required: true
description: Address of the spender
- schema:
type: string
example: Bearer cm_api_d286bc5a-9980-43b7-9507-7fc013fecca8
in: header
name: Authorization
required: true
description: Bearer token
- schema:
type: string
in: path
name: uuid
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
$ref: '#/components/schemas/AllowanceModel'
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getWalletsByUuidAllowances
x-operation-id-source: derived
/wallets/{uuid}/transactions:
get:
summary: Get a wallet transaction by id
tags:
- Wallets
parameters:
- schema:
type: string
example: d6ef5152-75ab-5a1d-9c2d-54b66251395c
in: query
name: refId
required: true
description: refId of the transaction
- schema:
type: string
example: 4942ccc4-b900-4e18-9ba6-2f720b352108
in: path
name: uuid
required: true
description: UUID of the wallet
- schema:
type: string
example: Bearer cm_api_d286bc5a-9980-43b7-9507-7fc013fecca8
in: header
name: Authorization
required: true
description: Bearer token
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/WalletTransactionModel'
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: getWalletsByUuidTransactions
x-operation-id-source: derived
post:
summary: Create a transaction challenge
tags:
- Wallets
requestBody:
content:
application/json:
schema:
type: object
properties:
idempotencyKey:
description: Unique value generated by the client, which the server uses to recognize subsequent retries of the same request. You must generate and provide an idempotency key formatted as a UUID version 4 format.
type: string
pattern: ^[0-9(a-f|A-F)]{8}-[0-9(a-f|A-F)]{4}-4[0-9(a-f|A-F)]{3}-[89ab][0-9(a-f|A-F)]{3}-[0-9(a-f|A-F)]{12}$
abiFunctionSignature:
description: The contract ABI function signature or `callData` field is required for interacting with the smart contract. The ABI function signature cannot be used simultaneously with `callData`. e.g. Burn(uint256).
type: string
abiParameters:
description: The contract ABI function signature parameters for executing the contract interaction. Supported parameter types include string, integer, boolean, and array. These parameters should be used exclusively with the abiFunctionSignature and cannot be used with `callData`.
type: array
items: {}
callData:
description: The raw transaction data, must be an even-length hexadecimal string with the `0x` prefix, to be executed. It is important to note that the usage of `callData` is mutually exclusive with the `abiFunctionSignature` and `abiParameters`. Therefore, `callData` cannot be utilized simultaneously with either `abiFunctionSignature` or `abiParameters`.
type: string
amount:
description: The amount of native token that will be sent to the contract abi execution. Optional field for payable api only, if not provided, no native token will be sent.
type: string
contractAddress:
description: Optional reference or description used to identify the transaction.
type: string
refId:
description: Optional reference or description used to identify the transaction.
type: string
fee:
anyOf:
- type: object
properties:
type:
type: string
enum:
- absolute
config:
type: object
properties:
maxFee:
description: "The maximum price per gas unit (see gasLimit), in gwei.\n Requires priorityFee, and gasLimit, but incompatible with feeLevel or gasPrice.\n Use the Estimate Fee methods to get this fee's estimates."
type: string
priorityFee:
description: "Requires maxFee, and gasLimit but incompatible with feeLevel or gasPrice.\n Use the Estimate Fee methods for fee estimates."
type: string
gasLimit:
description: "The maximum gas units for the transaction, required if feeLevel isn't provided.\n Use the Estimate Fee methods for this limit's estimation."
type: string
required:
- maxFee
- priorityFee
- gasLimit
required:
- type
- config
- type: object
properties:
type:
type: string
enum:
- gas
config:
type: object
properties:
gasLimit:
description: "The maximum gas units for the transaction, required if feeLevel isn't provided.\n Use the Estimate Fee methods for this limit's estimation."
type: string
gasPrice:
description: "For EIP-1559 supported blockchains, it's the max gas price per gas unit (see gasLimit), in gwei.\n Requires gasLimit and incompatible with feeLevel, priorityFee, or maxFee.\n Use the Estimate Fee methods for fee estimates."
type: string
required:
- gasLimit
- gasPrice
required:
- type
- config
- type: object
properties:
type:
type: string
enum:
- level
config:
type: object
properties:
feeLevel:
description: " A dynamic fee level setting (LOW, MEDIUM, HIGH) determining the gas price for the transaction,\n based on network conditions. Incompatible with gasLimit, gasPrice, priorityFee, or maxFee.\n Use the Estimate Fee methods for fee level estimates."
anyOf:
- type: string
enum:
- LOW
- type: string
enum:
- MEDIUM
- type: string
enum:
- HIGH
required:
- feeLevel
required:
- type
- config
required:
- idempotencyKey
- contractAddress
- fee
required: true
parameters:
- schema:
type: string
example: Bearer cm_api_d286bc5a-9980-43b7-9507-7fc013fecca8
in: header
name: Authorization
required: true
description: Bearer token
- schema:
type: string
in: path
name: uuid
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
challengeId:
type: string
encryptionKey:
type: string
userToken:
type: string
required:
- challengeId
- encryptionKey
- userToken
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
'500':
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
statusCode:
type: number
error:
type: string
operationId: postWalletsByUuidTransactions
x-operation-id-source: derived
components:
schemas:
WalletTransactionModel:
type: object
properties:
id:
description: ID of the transaction. This ID is generated internally
type: string
refId:
description: refId of the transaction. This ID is provided by the client
type: string
walletId:
description: ID of the wallet
type: string
status:
description: Status of the transaction
anyOf:
- title: INITIATED
type: string
enum:
- INITIATED
- title: QUEUED
type: string
enum:
- QUEUED
- title: CLEARED
type: string
enum:
- CLEARED
- title: SENT
type: string
enum:
- SENT
- title: PENDING_RISK_SCREENING
type: string
enum:
- PENDING_RISK_SCREENING
- title: CONFIRMED
type: string
enum:
- CONFIRMED
- title: CANCELLED
type: string
enum:
- CANCELLED
- title: COMPLETE
type: string
enum:
- COMPLETE
- title: FAILED
type: string
enum:
- FAILED
- title: DENIED
type: string
enum:
- DENIED
- title: ACCELERATED
type: string
enum:
- ACCELERATED
transactionHash:
description: Hash of the transaction
type: string
transactionError:
type: object
properties:
errorDetails:
type: string
errorReason:
type: string
required:
- id
- walletId
- status
Challenge:
type: object
properties:
challengeId:
description: Circle challenge ID
type: string
encryptionKey:
description: Circle encryption key
type: string
userToken:
description: Circle user token
type: string
required:
- challengeId
- encryptionKey
- userToken
AllowanceModel:
type: object
properties:
walletUuid:
description: ID of the wallet
type: string
tokenIdentifier:
description: Identifier of the token
type: string
allowance:
description: Amount allowed for transfer
type: number
spenderAddress:
description: Address of the spender
type: string
required:
- walletUuid
- tokenIdentifier
- allowance
- spenderAddress
Wallet:
type: object
properties:
address:
description: Blockchain address of the wallet
type: string
uuid:
format: uuid
description: UUID of the wallet
type: string
chain_id:
description: EVM chain ID of the wallet
type: number
example: 137
created_at:
type: string
updated_at:
type: string
required:
- address
- uuid
- chain_id
- created_at
- updated_at
externalDocs:
url: https://docs.carbonmark.com/
description: Additional documentation. The complete product and platform knowledge base for Carbonmark can be found here.