Skip to main content
Move funds between two of your end customers’ custodial accounts instantly and with no blockchain fees. You can verify balances on both the source and destination accounts before and after the transfer.

Prerequisites

Before you begin, ensure that you’ve:
  • Obtained an API key for Digital Asset Accounts from Circle.
  • Onboarded end customers with two active custodial accounts, each with an accountId. For details on how end customers and accounts relate, see Account structure.
  • Funded at least one of the accounts.
  • Reviewed whether Strong Customer Authentication (SCA) applies. Circle requires SCA headers on transfers for end customers in the European Economic Area (EEA). See Implement SCA.
  • Run a device check for the end customer and kept the deviceId it returns. Every transfer request carries it in riskSignals. See Collect device risk signals.
  • Installed cURL on your development machine.

Steps

Step 1. Check source and destination balances

Before creating the transfer, verify the balances of both accounts. The source account must have sufficient funds to cover the transfer amount. Check source balance
Response

Step 2. Create an internal transfer

Initiate the transfer by specifying both the source and destination as account types with their respective account IDs. Internal transfers complete instantly.
Response
Internal account-to-account transfers complete instantly and return a complete status in the response. There are no blockchain fees or processing delays.
If the source account has insufficient funds, the API returns an error. Verify the balance before creating a transfer.

Step 3. Verify both balances

Confirm that funds have moved correctly by checking the balances of both accounts. Source balance
Response
Destination balance
Response
The source account balance decreased by 2,500 USD and the destination account balance increased by the same amount.

Look up transfers

Get a transfer by ID

Retrieve the details of a specific transfer using the transfer ID returned when you created it.
Response

List transfers for an account

Retrieve all transfers for an account. This endpoint returns both internal and external transfers in reverse order and supports pagination.
Response

See also