Transfers & Withdrawals

private/transfer_spot_external

Submits a signed transfer of a single spot asset to a subaccount belonging to a different owner. Alongside the standard transfer fields (asset, sub_id, amount, nonce, signer, signature, expiry, max USD fee) you give the recipient's wallet address and either an existing destination subaccount or 0 to create a new one under new_subaccount_manager; the max fee must cover both the transfer and any subaccount-creation cost. Requires a session key permitted to transfer to a different owner and returns the operation id and uuid.

post/private/transfer_spot_external

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/private/transfer_spot_external
  • Auth: none declared

Request body

amountstring decimal required

Transfer amount in units of the asset, as a decimal string (e.g. "1.5") or JSON number.

asset_namestring required
max_fee_usdstring decimal required

Maximum sequencer fee the signer authorises, in USD, as a decimal string (e.g. "1.5") or a JSON number. Must cover both the transfer fee and any subaccount-creation fee.

new_subaccount_managerinteger required

Manager id for the new subaccount when to_subaccount_id == 0.

noncestring required
recipient_addressstring required

Owner of the destination account/subaccount.

signaturestring required
signature_expiry_secinteger required
signerstring required
sub_idinteger required
subaccount_idinteger required
to_subaccount_idinteger required

Recipient's existing destination subaccount. 0 → create a new subaccount for recipient_address under new_subaccount_manager.

Response

Success

op_uuidstring required
operation_idinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.