Cobo Developer Hub

This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.

Account Opening

To use Cobo Full Custody, you will need to create an account with Cobo first. Please contact Cobo to request an invitation email if you do not have an account yet. To improve security, you will need to download Google Authenticator (GA) on your mobile device. To complete the setup, please use your GA to scan the QR code displayed on the Cobo Custody Web.

You are also required to install Cobo Guard, which is a dedicated mobile application that leverages cutting-edge Trusted Execution Environment (TEE) technologies for secure authentication, risk control verification, and MPC-TSS key share management. It provides robust protection for your account, particularly during critical actions such as withdrawals and risk policy adjustments. Currently, Cobo Guard only supports the iOS system. The app is compatible with iPhone 5s and newer models, and the operating system must be iOS 13.0 or later. Prior to installation, kindly make sure that your mobile device meets the aforementioned requirements. To download Cobo Guard (development environment) from TestFlight, click here. Please be advised that Cobo Guard downloaded from the Apple Store will only be compatible with the production environment. After downloading Cobo Guard, you need to click on the scan icon on the top-right corner of your Cobo Guard to scan the QR code displayed on the Cobo Custody Web.

On the Cobo Custody Web, you can invite more team members to your org. To do so, head to Settings > Teams > Invite Users. Note that your invitees will also need to follow the aforementioned steps for setup and authentication.

Wallet Setup

You can now proceed to create a Full Custody wallet on the Cobo Custody Web. To add coins to your wallet, simply click “+Add Coins” and then search for your preferred coin types. Currently, Cobo Custody Web supports four mainnets (BTC, ETH, TRON, XRP) and two testnets (GETH, XTN).

Please make sure that you have added coins to your Full Custody wallets first before making any API calls.

API Integration

If you are using APIs, please first choose an appropriate SDK from Cobo’s GitHub repository. Cobo Custody provides SDKs in five programming languages - Java, PHP, Python, JavaScript and Go.

Java

PHP

Python

JavaScript

Go

Next, you will need to generate an API key and secret. The following code snippet provides an example using the Python SDK. You can locate instructions for generating API keys in the GitHub SDK README for your chosen programming language.

Python

from cobo_custody.signer.local_signer import generate_new_key
api_secret, api_key = generate_new_key()
print(api_secret)
print(api_key)

api_secret is your private key and should be stored securely.api_key is your public key and needs to be set in your WaaS account via Cobo Custody web interface.

After successfully generating an API key and opening an account, you can head to the API dashboard on the Cobo Custody Web. Please manually enter your key into the “API Key” field and ensure that the status of your API key is displayed as “Active”. You can now proceed to use the relevant SDKs to make API calls.

Test API by SDKs

Python

from cobo_custody.client import Client
from cobo_custody.config import DEV_ENV
from cobo_custody.signer.local_signer import LocalSigner

# input your API SECRET
signer = LocalSigner("YOUR_API_SECRET")
client = Client(signer=signer, env=DEV_ENV, debug=True)
res = client.get_account_info()

View Response

{
  "success": true,
  "result": {
    "name": "cobo_test",
    "assets": [
      {
        "coin": "ADA",
        "display_code": "ADA",
        "description": "Cardano",
        "decimal": 6,
        "can_deposit": true,
        "can_withdraw": true,
        "require_memo": false,
        "balance": "29880892",
        "abs_balance": "29.880892",
        "fee_coin": "ADA",
        "abs_estimate_fee": "1",
        "confirming_threshold": 9,
        "dust_threshold": 1000000,
        "token_address": ""
      },
      {
        "coin": "ALGO",
        "display_code": "ALGO",
        "description": "Algorand",
        "decimal": 6,
        "can_deposit": true,
        "can_withdraw": true,
        "require_memo": false,
        "balance": "8359337",
        "abs_balance": "8.359337",
        "fee_coin": "ALGO",
        "abs_estimate_fee": "0.8",
        "confirming_threshold": 12,
        "dust_threshold": 1,
        "token_address": ""
      }
    ]
  }
}

Test API by Playground

To learn what is Playground, please refer to the (Interactive API Playground) section.

​Account Opening

​Wallet Setup

​API Integration

Java

PHP

Python

JavaScript

Go

​Test API by SDKs

​Test API by Playground

Account Opening

Wallet Setup

API Integration

Test API by SDKs

Test API by Playground