v1

latestOpenAPI 3.0.02026-07-267331140.7 KB

Account Management

Withdraw from Safe with Signature

Withdraws ERC20 tokens or native tokens (xDAI) from the user's Safe account.

For ERC20 tokens, provide the token contract address. For native token (xDAI) withdrawals, use "0x0000000000000000000000000000000000000000" as the tokenAddress.

The signature should be generated by signing the transaction data obtained from the /api/v1/accounts/withdraw/transaction-data endpoint.

The withdrawal is processed through a delay relay mechanism that executes after 3 minutes.

post/api/v1/accounts/withdraw

Request body

amountstring required

The amount to withdraw in the token's base units.

tostring required

The address to withdraw to.

tokenAddressstring required

The address of the token to withdraw. Use "0x0000000000000000000000000000000000000000" for native token (xDAI) withdrawals.

signaturestring required

The wallet signature authorizing this withdraw.

smartWalletAddressstring

Optional. If using a smart account, the address of the smart wallet to use for the withdraw.

Example request

{
  "amount": "1000000000000000000",
  "to": "0x3270bf32AB647e90eF94A026c70Aa1daaaDA2382",
  "tokenAddress": "0x3270bf32AB647e90eF94A026c70Aa1daaaDA2382",
  "signature": "0x1234567890abcdef...",
  "message": {
    "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "data": "0xa9059cbb0000000000000000000000003270bf32ab647e90ef94a026c70aa1daaaada23820000000000000000000000000000000000000000000000000de0b6b3a7640000"
  },
  "smartWalletAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

Response

Successfully submitted the withdraw request.

Example response

{
  "data": {
    "id": "clp3j1f9a0000a1cdh6ezx2qv",
    "safeAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "transactionData": "{\"to\":\"0x123\",\"value\":\"0\",\"data\":\"0xabcdef\"}",
    "enqueueTaskId": "task_abc123",
    "operationType": "CALL",
    "userId": "user_123",
    "status": "QUEUING",
    "createdAt": "2025-02-07T12:34:56Z"
  }
}