Crypto to External Wallet

Crypto to External Wallet transfers allow you to send cryptocurrency from a customer's managed wallet to any external wallet address.

Prepare the transfer request

Make sure you have the customer ID ready. This is the unique identifier for the customer who wants to send cryptocurrency to an external wallet.

For this guide, we'll use the customer ID cus_cK69MttD5nAUAbud1B.

Make the API request

Call the POST /v1/transfers endpoint with the following request:

curl https://wallet.swipelux.com/v1/transfers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_API_KEY' \
  --data '{
    "onBehalfOf": "cus_cK69MttD5nAUAbud1B",
    "amount": "50.0",
    "source": {
      "paymentRail": "crypto"
    },
    "destination": {
      "walletAddress": "0xabcdef..."
    }
  }'

The amount parameter denotes the cryptocurrency amount to transfer.

Make sure the customer has sufficient balance in their managed wallet to cover the transfer amount plus any network fees.

Handle the response

The API will return a JSON response containing the transfer details:

Response body

{
  "id": "tr_nEZHWur1pBSAKY7NlV",
  "onBehalfOf": "cus_cK69MttD5nAUAbud1B",
  "state": "processing",
  "amount": "50.0",
  "source": {
    "paymentRail": "crypto"
  },
  "destination": {
    "walletAddress": "0xabcdef..."
  },
  "createdAt": "2025-04-29T10:54:08.724Z",
  "updatedAt": "2025-04-29T10:54:08.724Z"
}

Unlike on-ramp transfers, crypto transfers are processed automatically. You can monitor the transfer status by polling the transfer endpoint or setting up webhooks to receive notifications when the transfer completes.

The transfer will typically complete within a few minutes, depending on network congestion and confirmation requirements.

Prepare the transfer request

Make the API request

Handle the response

Monitor transfer completion

On this page