curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/withdraw \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"assets": [
{
"address": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"amount": "0.5",
"id": "ae455f23-3824-4125-baab-d158315cbcbd",
"metadata": {
"id": "0001"
},
"note": "Payment for service 0",
"reference": "new multi0"
},
{
"address": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"amount": "0.5",
"id": "ae455f23-3824-4125-baab-d158315cbcbd",
"metadata": {
"id": "0002"
},
"note": "Payment service 1",
"reference": "new multi1"
}
]
}
'{
"data": {
"amlScreening": null,
"amount": "10",
"amountPaid": "10",
"asset": {
"address": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
"blockchain": {
"createdAt": "2024-05-14T11:53:33.095Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "85ffc132-3972-4c9e-99a5-5cf0ccb688bf",
"isActive": true,
"isEvmCompatible": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png",
"name": "ethereum",
"slug": "ethereum",
"symbol": "eth",
"tokenStandard": "ERC20",
"updatedAt": "2024-06-14T22:32:11.983Z"
},
"createdAt": "2024-05-14T11:53:33.682Z",
"decimals": 6,
"id": "fe04a28c-c615-4e41-8eda-f84c862864f5",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
"name": "USDC Coin",
"network": "testnet",
"standard": "ERC20",
"symbol": "USDC",
"updatedAt": "2024-06-14T22:32:12.589Z"
},
"assetSwept": null,
"assetSweptAmount": null,
"assetSweptAt": null,
"assetSweptGasFee": null,
"assetSweptHash": null,
"assetSweptRecipientAddress": null,
"assetSweptResponse": null,
"assetSweptSenderAddress": null,
"blockHash": null,
"blockNumber": null,
"blockchain": {
"createdAt": "2024-05-14T11:53:33.095Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "85ffc132-3972-4c9e-99a5-5cf0ccb688bf",
"isActive": true,
"isEvmCompatible": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png",
"name": "ethereum",
"slug": "ethereum",
"symbol": "eth",
"tokenStandard": "ERC20",
"updatedAt": "2024-06-14T22:32:11.983Z"
},
"chainId": null,
"confirmations": null,
"confirmed": false,
"createdAt": "2024-10-23T11:33:58.765Z",
"currency": "USD",
"fee": null,
"feeMetadata": null,
"gasFee": null,
"gasPrice": null,
"gasUsed": null,
"hash": "0xded90bc7f3d98f5ff0c3a97f711717192e83e01d89ac1ff4483ae6fd9d229e6d",
"id": "081d6315-159f-4c38-b02a-c4708836c5bd",
"metadata": null,
"network": "testnet",
"note": null,
"reason": null,
"recipientAddress": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"status": "PENDING",
"tokenAddress": null,
"type": "WITHDRAW",
"updatedAt": "2024-10-23T11:33:58.765Z",
"wallet": {
"id": "d236a191-c1d4-423c-a439-54ce6542ca41"
}
},
"message": "Withdrawal request initiated successfully",
"statusCode": 200
}This endpoint allows you to initiate a withdrawal from a specific wallet.
| Key | Required | Type | Description |
|---|---|---|---|
| assetId | true* | string (UUID) | The ID of the asset to withdraw. Required if assets array is not provided. |
| address | true* | string | The destination wallet address for the withdrawal. Required if assets array is not provided. |
| amount | true* | string | The withdrawal amount. Must be greater than 0. Required if assets array is not provided. |
| reference | false | string | An optional reference note for the withdrawal. |
| note | false | string | A short message or internal remark to associate with this withdrawal. Not visible on-chain. |
| metadata | false | object | Optional metadata (key-value pairs) for additional transaction details. |
| assets | false | array of Asset | Used for batch withdrawals. Required if assetId, amount, and address are not provided. |
| Key | Required | Type | Description |
|---|---|---|---|
| id | true | string (UUID) | The ID of the asset to withdraw. |
| amount | true | string | The withdrawal amount. Must be greater than 0. |
| address | true | string | The destination wallet address for the withdrawal. |
| reference | false | string | Optional reference note for this asset withdrawal. |
| note | false | string | A short message or internal remark for this asset withdrawal. Not visible on-chain. |
| metadata | false | object | Optional metadata (key-value pairs) for this asset withdrawal. |
Single withdrawal: Provide assetId, amount, and address at the top level.
Batch withdrawal: Omit top-level assetId, amount, and address, and instead provide an array of assets (each following Asset).
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/withdraw \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"assets": [
{
"address": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"amount": "0.5",
"id": "ae455f23-3824-4125-baab-d158315cbcbd",
"metadata": {
"id": "0001"
},
"note": "Payment for service 0",
"reference": "new multi0"
},
{
"address": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"amount": "0.5",
"id": "ae455f23-3824-4125-baab-d158315cbcbd",
"metadata": {
"id": "0002"
},
"note": "Payment service 1",
"reference": "new multi1"
}
]
}
'{
"data": {
"amlScreening": null,
"amount": "10",
"amountPaid": "10",
"asset": {
"address": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
"blockchain": {
"createdAt": "2024-05-14T11:53:33.095Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "85ffc132-3972-4c9e-99a5-5cf0ccb688bf",
"isActive": true,
"isEvmCompatible": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png",
"name": "ethereum",
"slug": "ethereum",
"symbol": "eth",
"tokenStandard": "ERC20",
"updatedAt": "2024-06-14T22:32:11.983Z"
},
"createdAt": "2024-05-14T11:53:33.682Z",
"decimals": 6,
"id": "fe04a28c-c615-4e41-8eda-f84c862864f5",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
"name": "USDC Coin",
"network": "testnet",
"standard": "ERC20",
"symbol": "USDC",
"updatedAt": "2024-06-14T22:32:12.589Z"
},
"assetSwept": null,
"assetSweptAmount": null,
"assetSweptAt": null,
"assetSweptGasFee": null,
"assetSweptHash": null,
"assetSweptRecipientAddress": null,
"assetSweptResponse": null,
"assetSweptSenderAddress": null,
"blockHash": null,
"blockNumber": null,
"blockchain": {
"createdAt": "2024-05-14T11:53:33.095Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "85ffc132-3972-4c9e-99a5-5cf0ccb688bf",
"isActive": true,
"isEvmCompatible": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png",
"name": "ethereum",
"slug": "ethereum",
"symbol": "eth",
"tokenStandard": "ERC20",
"updatedAt": "2024-06-14T22:32:11.983Z"
},
"chainId": null,
"confirmations": null,
"confirmed": false,
"createdAt": "2024-10-23T11:33:58.765Z",
"currency": "USD",
"fee": null,
"feeMetadata": null,
"gasFee": null,
"gasPrice": null,
"gasUsed": null,
"hash": "0xded90bc7f3d98f5ff0c3a97f711717192e83e01d89ac1ff4483ae6fd9d229e6d",
"id": "081d6315-159f-4c38-b02a-c4708836c5bd",
"metadata": null,
"network": "testnet",
"note": null,
"reason": null,
"recipientAddress": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"status": "PENDING",
"tokenAddress": null,
"type": "WITHDRAW",
"updatedAt": "2024-10-23T11:33:58.765Z",
"wallet": {
"id": "d236a191-c1d4-423c-a439-54ce6542ca41"
}
},
"message": "Withdrawal request initiated successfully",
"statusCode": 200
}"YOUR_WALLET_ID"
Show child attributes
"0x451dEFC27B45808078e875556AF06bCFdC697BA4"
"0.5"
"ae455f23-3824-4125-baab-d158315cbcbd"
"Payment for service 0"
"new multi0"
[
{
"address": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"amount": "0.5",
"id": "ae455f23-3824-4125-baab-d158315cbcbd",
"metadata": { "id": "0001" },
"note": "Payment for service 0",
"reference": "new multi0"
},
{
"address": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"amount": "0.5",
"id": "ae455f23-3824-4125-baab-d158315cbcbd",
"metadata": { "id": "0002" },
"note": "Payment service 1",
"reference": "new multi1"
}
]200 / Multi Asset Success
Show child attributes
"10"
"10"
Show child attributes
"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238"
Show child attributes
"2024-05-14T11:53:33.095Z"
"m/44'/60'/0'/0"
"85ffc132-3972-4c9e-99a5-5cf0ccb688bf"
true
true
"https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png"
"ethereum"
"ethereum"
"eth"
"ERC20"
"2024-06-14T22:32:11.983Z"
"2024-05-14T11:53:33.682Z"
6
"fe04a28c-c615-4e41-8eda-f84c862864f5"
true
"https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png"
"USDC Coin"
"testnet"
"ERC20"
"USDC"
"2024-06-14T22:32:12.589Z"
Show child attributes
"2024-05-14T11:53:33.095Z"
"m/44'/60'/0'/0"
"85ffc132-3972-4c9e-99a5-5cf0ccb688bf"
true
true
"https://res.cloudinary.com/blockradar/image/upload/v1716800081/crypto-assets/ethereum-eth-logo_idraq2.png"
"ethereum"
"ethereum"
"eth"
"ERC20"
"2024-06-14T22:32:11.983Z"
false
"2024-10-23T11:33:58.765Z"
"USD"
[]"0xded90bc7f3d98f5ff0c3a97f711717192e83e01d89ac1ff4483ae6fd9d229e6d"
"081d6315-159f-4c38-b02a-c4708836c5bd"
"testnet"
"0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
"0x947514e4B803e312C312da0F1B41fEDdbe15ae7a"
"PENDING"
Show child attributes
"0.1"
"0.1"
Show child attributes
"0x337610d27c682E347C9cD60BD4b3b107C9d34dDd"
Show child attributes
"2024-05-14T17:53:33.106Z"
"m/44'/60'/0'/0"
"b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa"
true
true
false
"https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png"
"BNB smart chain"
"bnb-smart-chain"
"bnb"
"BEP20"
"2024-11-26T19:04:13.941Z"
"2024-05-14T17:53:33.680Z"
18
"1890db58-f624-4972-a72b-e25387a81520"
true
"https://res.cloudinary.com/blockradar/image/upload/v1716800082/crypto-assets/tether-usdt-logo_wx7rwh.png"
"Tether USD"
"testnet"
"BEP20"
"USDT"
"2024-06-15T04:36:43.868Z"
Show child attributes
"2024-05-14T17:53:33.106Z"
"m/44'/60'/0'/0"
"b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa"
true
true
false
"https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png"
"BNB smart chain"
"bnb-smart-chain"
"bnb"
"BEP20"
"2024-11-26T19:04:13.941Z"
false
"2024-12-09T22:58:10.210Z"
"USD"
"224cd1b0-c3a3-4783-85d9-28f3ba20fea5"
"testnet"
"0x451dEFC27B45808078e875556AF06bCFdC697BA4"
"0x947514e4B803e312C312da0F1B41fEDdbe15ae7a"
"PENDING"
"WITHDRAW"
"2024-12-09T22:58:10.210Z"
Show child attributes
"0x947514e4B803e312C312da0F1B41fEDdbe15ae7a"
"2024-08-22T15:29:11.387Z"
"m/44'/60'/0'/0/0"
"This is BNB smart chain testnet master wallet"
"4465468a-3c36-4536-918a-91d689e18a74"
true
"BNB smart chain Master Wallet"
"testnet"
"ACTIVE"
"2024-10-30T13:11:56.221Z"
[
{
"amlScreening": null,
"amount": "0.1",
"amountPaid": "0.1",
"asset": {
"address": "0x337610d27c682E347C9cD60BD4b3b107C9d34dDd",
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"createdAt": "2024-05-14T17:53:33.680Z",
"decimals": 18,
"id": "1890db58-f624-4972-a72b-e25387a81520",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800082/crypto-assets/tether-usdt-logo_wx7rwh.png",
"name": "Tether USD",
"network": "testnet",
"standard": "BEP20",
"symbol": "USDT",
"updatedAt": "2024-06-15T04:36:43.868Z"
},
"assetSwept": null,
"assetSweptAmount": null,
"assetSweptAt": null,
"assetSweptGasFee": null,
"assetSweptHash": null,
"assetSweptRecipientAddress": null,
"assetSweptResponse": null,
"assetSweptSenderAddress": null,
"blockHash": null,
"blockNumber": null,
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"chainId": null,
"confirmations": null,
"confirmed": false,
"createdAt": "2024-12-09T22:58:10.210Z",
"currency": "USD",
"fee": null,
"feeMetadata": null,
"gasFee": null,
"gasPrice": null,
"gasUsed": null,
"hash": null,
"id": "224cd1b0-c3a3-4783-85d9-28f3ba20fea5",
"metadata": null,
"network": "testnet",
"note": null,
"reason": null,
"recipientAddress": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"response": null,
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"status": "PENDING",
"tokenAddress": null,
"type": "WITHDRAW",
"updatedAt": "2024-12-09T22:58:10.210Z",
"wallet": {
"address": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"business": {
"id": "4b96c271-35eb-45e8-b558-6a53f95df601",
"name": "Test One Inc"
},
"createdAt": "2024-08-22T15:29:11.387Z",
"derivationPath": "m/44'/60'/0'/0/0",
"description": "This is BNB smart chain testnet master wallet",
"id": "4465468a-3c36-4536-918a-91d689e18a74",
"isActive": true,
"name": "BNB smart chain Master Wallet",
"network": "testnet",
"status": "ACTIVE",
"updatedAt": "2024-10-30T13:11:56.221Z"
}
},
{
"amlScreening": null,
"amount": "0.001",
"amountPaid": "0.001",
"asset": {
"address": "0x0000000000000000000000000000000000000000",
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"createdAt": "2024-05-14T17:53:33.678Z",
"decimals": 18,
"id": "ef2458b5-b292-4f5a-89c4-71c8576e6272",
"isActive": true,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "Binance Coin",
"network": "testnet",
"standard": null,
"symbol": "BNB",
"updatedAt": "2024-10-27T13:52:16.162Z"
},
"assetSwept": null,
"assetSweptAmount": null,
"assetSweptAt": null,
"assetSweptGasFee": null,
"assetSweptHash": null,
"assetSweptRecipientAddress": null,
"assetSweptResponse": null,
"assetSweptSenderAddress": null,
"blockHash": null,
"blockNumber": null,
"blockchain": {
"createdAt": "2024-05-14T17:53:33.106Z",
"derivationPath": "m/44'/60'/0'/0",
"id": "b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa",
"isActive": true,
"isEvmCompatible": true,
"isL2": false,
"logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png",
"name": "BNB smart chain",
"slug": "bnb-smart-chain",
"symbol": "bnb",
"tokenStandard": "BEP20",
"updatedAt": "2024-11-26T19:04:13.941Z"
},
"chainId": null,
"confirmations": null,
"confirmed": false,
"createdAt": "2024-12-09T22:58:11.626Z",
"currency": "BNB",
"fee": null,
"feeMetadata": null,
"gasFee": null,
"gasPrice": null,
"gasUsed": null,
"hash": null,
"id": "6adfcfd4-d1ed-4c46-9683-a7524f50ef10",
"metadata": null,
"network": "testnet",
"note": null,
"reason": null,
"recipientAddress": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
"response": null,
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"status": "PENDING",
"tokenAddress": null,
"type": "WITHDRAW",
"updatedAt": "2024-12-09T22:58:11.626Z",
"wallet": {
"address": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"business": {
"id": "4b96c271-35eb-45e8-b558-6a53f95df601",
"name": "Test One Inc"
},
"createdAt": "2024-08-22T15:29:11.387Z",
"derivationPath": "m/44'/60'/0'/0/0",
"description": "This is BNB smart chain testnet master wallet",
"id": "4465468a-3c36-4536-918a-91d689e18a74",
"isActive": true,
"name": "BNB smart chain Master Wallet",
"network": "testnet",
"status": "ACTIVE",
"updatedAt": "2024-10-30T13:11:56.221Z"
}
}
]"WITHDRAW"
"2024-10-23T11:33:58.765Z"
"Withdrawal request initiated successfully"
200