Skip to main content
Digital Asset Accounts organizes funds in two levels. You onboard each of your end customers, and each end customer holds one or more accounts. Each account is either custodial, where Circle holds the assets, or non-custodial, where the end customer holds them.

Roles

How end customers and accounts relate

  • End customer: a business that you onboard through the End User Onboarding API. The API identifies the end customer by its clientEntityId. After Circle approves KYB, it activates the end customer and creates their first custodial account. Circle also assigns each end customer a risk rating during KYB, which sets the transaction limits on their accounts. For the onboarding steps, see Onboard customers.
  • Account: holds funds for one end customer, and has its own accountId, balances, and transaction history. An end customer can hold more than one account. For example, they can hold separate accounts for different purposes, or both a custodial and a non-custodial account.
Deposits, wire withdrawals, and transfers are recorded against a specific account. Internal transfers move funds between your end customers’ custodial accounts instantly and at no cost.

Custodial and non-custodial accounts

An account’s custodyType shows whether it’s custodial or non-custodial. Both types are Digital Asset Accounts, and both belong to an end customer that you’ve onboarded. They differ in who holds the assets, how a debit is approved, and what each request needs: You can offer your end customers custodial accounts, non-custodial accounts, or both.