Transfer Between Wallets

post

https://api.bitfinex.com/v2/auth/w/transfer

Transfer funds between wallets. This endpoint can also be used to convert USDT to USDT0 for derivatives trading.

Response data

Index	Field	Type	Description
[0]	MTS	int	Seconds epoch timestamp of notification
[1]	TYPE	string	Notification's type ("on-req")
[2]	MESSAGE_ID	int	Unique notification's ID
[ . . . ]
[4]	TRANSFER_ARRAY	TRANSFER_ARRAY	An array containing details of the transfer/conversion
[5]	CODE	int	W.I.P. (work in progress)
[6]	STATUS	string	Status of the notification; it may vary over time (SUCCESS, ERROR, FAILURE, ...)
[7]	TEXT	string	Additional notification description

Transfer array (index [4])

Index	Field	Type	Description
[0]	MTS_UPDATED	Int	Millisecond Time Stamp of the update
[1]	WALLET_FROM	String	Starting wallet
[2]	WALLET_TO	String	Destination wallet
[ . . . ]
[4]	CURRENCY	String	Currency
[5]	CURRENCY_TO	String	Currency converted to
[ . . . ]
[7]	AMOUNT	Int	Amount of Transfer

📘
Derivatives Wallet
Note that the margin wallet, for Derivative symbols, is the derivatives wallet. If the destination is 'margin' and the currency_to is 'USTF0', the funds will end up in the derivatives wallet.

Body Params

from

string

required

Defaults to trading

Select the wallet from which to transfer (exchange, margin, funding (can also use the old labels which are exchange, trading and deposit respectively))

string

required

Defaults to exchange

Select the wallet to transfer to (exchange, margin, funding (can also use the old labels which are exchange, trading and deposit respectively))

currency

string

required

Defaults to UST

Select the currency that you would like to transfer (USD, UST, BTC, ....)

currency_to

string

Defaults to USTF0

Select the currency that you would like to exchange to (USTF0 === USDT for derivatives pairs)

amount

string

required

Defaults to 123.45

Select the amount to transfer

email_dst

string

Allows transfer of funds to a sub- or master-account identified by the associated email address.

user_id_dst

int32

Allows transfer of funds to a sub- or master-account identified by the associated user id.

tfaToken

object

Required only when email_dst or user_id_dst is present and auth token is used instead of api credentials

Responses

Response data

Transfer array (index [4])

Derivatives Wallet

200200

400400