Carbonmark Wallets API

The Wallets API from Carbonmark — 4 operation(s) for wallets.

GitHub OpenAPI

Operations 5

POST /wallets Create a team wallet #
GET /wallets/{uuid} Get a wallet information #
GET /wallets/{uuid}/allowances Get wallet allowances for the given holdings #
GET /wallets/{uuid}/transactions Get a wallet transaction by id #
POST /wallets/{uuid}/transactions Create a transaction challenge #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/carbonmark-com:carbonmark-com-wallets-api"
All apis
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.

Get an API 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 Specification

carbonmark-com-wallets-api-openapi.yml Raw ↑
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.