Request a withdrawal from a vault
Submits a signed withdraw action that enqueues a request to burn a given number of vault shares and redeem the proceeds to the user’s subaccount. Inputs are the vault subaccount and the share quantity to burn (decimal string). Returns an acknowledgement with the queued request; requires the user-withdraw permission.
Body
Fields common to every signed vault action. They appear alongside each endpoint's action-specific parameters in the same request object.
x >= 0Number of vault shares to burn, as a decimal string.
0x-prefixed hex of the 65-byte EOA signature.
x >= 020-byte Ethereum address as a 0x-prefixed lowercase hex string.
42^0x[0-9a-fA-F]{40}$The subaccount the action is signed on; which subaccount applies depends on the specific method — see that method's reference.
x >= 0x >= 0Response
Success
Returned by request_vault_deposit / request_vault_withdraw: the id the queued request was assigned (the user's handle for polling / cancelling).
Composite vault request id: (vault_subaccount_id, wallet, vault_nonce)
Useful as a stable dedup key across off-chain and on-chain vault events.
Related topics
Page a vault's pending withdrawal requestsSettle a queued vault withdrawalGet a wallet's paginated vault request history