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. The customer must have sufficient balance in their wallet to cover the transfer amount plus network fees.

Prepare the transfer request

Make sure you have:

Customer ID: The unique identifier for the customer
External wallet address: The destination address for the crypto transfer
Sufficient balance: Customer must have enough cryptocurrency + network fees

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

Make the API request

Call the POST /v1/transfers endpoint using the polygon rail for crypto transfers:

curl https://wallet.swipelux.com/v1/transfers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_API_KEY' \
  --data '{
    "from": {
      "identifier": "cus_cK69MttD5nAUAbud1B",
      "amount": "25",
      "rail": "polygon",
      "currency": "USDC"
    },
    "to": {
      "identifier": "0x1234567890abcdef1234567890abcdef12345678",
      "rail": "polygon",
      "currency": "USDC"
    }
  }'

Key differences for crypto transfers:

Use rail: "polygon" and currency: "USDC" for both from and to
from.identifier: Customer ID (their wallet)
to.identifier: External wallet address (not customer ID)
Transfers are processed automatically on-chain

Handle the response

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

Success Response

{
  "id": "tr_nEZHWur1pBSAKY7NlV",
  "from": {
    "identifier": "cus_cK69MttD5nAUAbud1B",
    "amount": "25",
    "rail": "polygon",
    "currency": "USDC"
  },
  "to": {
    "identifier": "0x1234567890abcdef1234567890abcdef12345678",
    "rail": "polygon", 
    "currency": "USDC"
  },
  "state": "processing",
  "url": "https://polygonscan.com/tx/0x123abc...",
  "createdAt": "2025-04-29T10:54:08.724Z",
  "updatedAt": "2025-04-29T10:54:08.724Z"
}

Note: For crypto transfers, the url field contains a blockchain explorer link to track the transaction, while fiat transfers contain payment URLs.

Monitor transfer completion

Crypto transfers are processed automatically on-chain. You can:

Poll the transfer endpoint: Check status updates
Set up webhooks: Receive notifications when transfers complete
Track on-chain: Use the url field to view transaction on blockchain explorer

Transfers typically complete within 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