Skip to main content
Send stablecoins from a Digital Asset Account to an external blockchain address, then track the transfer as it moves through processing states and confirms onchain. These steps apply to custodial and non-custodial accounts. Where they differ, choose the tab for your account type.

Prerequisites

Before you begin, ensure that you’ve:
  • Obtained an API key for Digital Asset Accounts from Circle.
  • Onboarded the end customer and funded their account.
  • Registered the destination as a recipient address, and waited until its status is active or verification_succeeded. See Manage recipient addresses.
  • Run a device check for the end customer and kept the deviceId it returns. Every transfer carries it in riskSignals. See Collect device risk signals.
  • Installed cURL on your development machine.
  • For end customers in the European Economic Area (EEA), prepared a Strong Customer Authentication (SCA) assertion. Transfers are SCA-gated. See Implement SCA.
  • For a non-custodial account, created the account and a DaaUserClient for the end customer, and set up your backend relay. See Create a non-custodial account.

Steps

Step 1. Create a transfer

Initiate a transfer to the registered recipient address. Specify the source account as an account type and the destination as a verified_blockchain type. The verified_blockchain type indicates a pre-registered external blockchain address. Set destination.addressId to the id of a recipient address whose status is active or verification_succeeded.
Response
For end customers in the EEA, add the X-Sca-Challenge-Id and X-Sca-Assertion headers. If the source account has insufficient funds, the API returns an error. Check the account balance before creating a transfer.

Step 2. Check the transfer status

Monitor the transfer until it reaches a terminal state. Transfers move through pending, complete, and failed states. See Transaction states for details. Instead of polling, you can subscribe to webhook notifications for transfer status changes.
Response

Step 3. Verify the balance

Confirm that the transfer amount has been deducted from the account.
Response

See also