Transfers & Withdrawals

private/transfer_spot

Submits a signed transfer of a single spot asset from one subaccount to another subaccount you own. You specify the source and destination subaccounts (or set new_subaccount_manager to create a new destination subaccount under a manager), the asset and its sub_id, the amount, a nonce, signer, signature with expiry, and the maximum USD sequencer fee. Requires a session key with a transfer permission and returns the operation id and uuid.

post/private/transfer_spot

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/private/transfer_spot
  • 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.

new_subaccount_managerinteger required

Non-zero → create a new sender-owned subaccount under this manager id.

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

Existing destination subaccount. Ignored when new_subaccount_manager != 0.

Response

Success

op_uuidstring required
operation_idinteger required

Changes

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