Skip to main content
POST
/
v1
/
wallets
/
{walletId}
/
withdraw
Master Wallet
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": "0xRecipient1Address",
      "amount": "10.5",
      "id": "{{assetId1}}",
      "metadata": {
        "employeeId": "EMP001"
      },
      "note": "Salary payment",
      "reference": "payout-001"
    },
    {
      "address": "0xRecipient2Address",
      "amount": "25.0",
      "id": "{{assetId2}}",
      "metadata": {
        "invoiceId": "INV-123"
      },
      "note": "Vendor payment",
      "reference": "payout-002"
    }
  ]
}
'
{
  "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
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
walletId
string
required
Example:

"YOUR_WALLET_ID"

Body

application/json
​
assets
object[]
Example:
[
  {
    "address": "0xRecipient1Address",
    "amount": "10.5",
    "id": "{{assetId1}}",
    "metadata": { "employeeId": "EMP001" },
    "note": "Salary payment",
    "reference": "payout-001"
  },
  {
    "address": "0xRecipient2Address",
    "amount": "25.0",
    "id": "{{assetId2}}",
    "metadata": { "invoiceId": "INV-123" },
    "note": "Vendor payment",
    "reference": "payout-002"
  }
]

Response

200 - application/json

Withdraw / Withdraw (Batch)

​
data
object
​
message
string
Example:

"Withdrawal request initiated successfully"

​
statusCode
number
Example:

200