Transfer
https://sandboxapi.bitnob.co/api/v1/wallets/transfer
Trigger a transfer to your customers using the specified blockchain network and stablecoin.
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | int | ✅ | Transfer amount in cents. |
| address | string | ✅ | Recipient's wallet address. |
| chain | string | ✅ | Blockchain network (bsc, tron,polygon,ethereum). |
| assetType | string | ✅ | Stablecoin type (USDT, USDC). |
| customerEmail | string | ❌ | Customer's email (optional). |
| reference | string | ✅ | Unique transfer reference. |
| description | string | ❌ | Description for the transfer. |
Request
Wallets/Trigger Transfer [POST]
curl --location --request POST \
'https://sandboxapi.bitnob.co/api/v1/wallets/transfer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API-KEY' \
--data-raw '{
"amount": 100,
"address": "0x8Da4d153ca75f8E4B1a62c41e0203c88632Bc1FC",
"chain": "bsc",
"assetType": "USDT",
"customerEmail": "customer2@gmail.com",
"reference": "_ksXfIb6t6E_rlo",
"description": "a description"
}'Responses
🟢 200 - Successful
{
"status": true,
"message": "sending STABLECOIN in progress",
"data": {
"id": "90d7ffb5-a484-437f-bc35-1e304a23e3ac",
"createdAt": "2024-12-11T19:12:37.556Z",
"updatedAt": "2024-12-11T19:12:37.556Z",
"reference": "SND_SBLNC_cfb04fb043bb",
"description": "Send USDC payment",
"balanceAfter": "505608",
"amount": "100",
"centAmount": "10000",
"fees": "1.2",
"centFees": "120",
"address": "tb1q7wu9t0gn94jq7pmj6vxvr9utnwwacwj3cwhqgg",
"action": "send_usdc",
"type": "debit",
"status": "pending",
"channel": "onchain",
"chain": "bsc",
"assetType": "USDC",
"companyId": "253058a4-a525-4e82-9b6d-e09feee91119"
}
}