Creating a New Blockchain Account

Overview

A blockchain account serves as the bridge between traditional banking and blockchain operations. It enables your customers to:

Receive crypto deposits
Make crypto withdrawals
Participate in tokenized deposit transfers

Prerequisites

Active bank deposit account (checking or savings)
Valid authentication token
Customer classification determined (retail or commercial)

Step 1: Create the Blockchain Account

Send a POST request to create a new blockchain account:

POST /blockchain-accounts
Authorization: Bearer {your-api-key}
Content-Type: application/json

{
  "bankAccountId": "DDA123456789",
  "bankAccountType": "checking",
  "type": "retail"
}

Request Parameters

Parameter	Type	Required	Description
`bankAccountId`	string	Yes	Reference to the underlying bank account in the bank's core system
`bankAccountType`	string	Yes	Type of the linked bank account (`checking` or `savings`)
`type`	string	Yes	Customer segment (`retail` or `commercial`)

Example Response

{
  "type": "blockchain-account",
  "id": "BCA_01BX5ZZKBKACTAV9WEVGEMMVS1",
  "depositAddresses": [
    {
      "type": "blockchain-account-deposit-address",
      "currency": {
        "type": "stablecoin-currency",
        "symbol": "USDC",
        "network": "solana"
      },
      "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
    }
  ],
  "bankAccountId": "DDA123456789",
  "bankAccountType": "checking",
  "classification": "retail"
}

Step 2: Understand the Response

The successful response includes:

id: Unique identifier for your blockchain account
depositAddresses: Array of blockchain addresses for receiving different currencies
bankAccountId: Reference back to your traditional bank account
classification: Your customer type (determines features and limits)

Step 3: Save Important Information

Store the following information for future API calls:

Blockchain account ID: BCA_01BX5ZZKBKACTAV9WEVGEMMVS1
Deposit addresses for each supported currency

Next Steps

After creating your blockchain account, you can:

Set up transaction limits - Configure deposit, withdrawal, and payment limits
Register counterparties - Add trusted wallets for withdrawals and deposits
Make deposits - Start receiving crypto payments

Error Handling

Common error responses:

Status Code	Error	Solution
400	Invalid bank account reference	Verify the bank account reference ID
400	Invalid customer type	Use either "retail" or "commercial"
401	Unauthorized	Check your authentication token

Security Notes

Deposit addresses are public and safe to share
Never share your api key

API Reference

Endpoint: POST /blockchain-accounts
Authentication: API key required
Rate Limits: Standard API rate limits apply
Related Endpoints:
- POST /blockchain-accounts/{id}/counterparties - Add trusted wallets
- POST /blockchain-accounts/{id}/transaction-limits - Set limits
- GET /blockchain-accounts/{id}/deposit-addresses - View deposit addresses