Withdrawal

post

https://api.bitfinex.com/v1/withdraw

Allow you to request a withdrawal from one of your wallet.

📘
Note
For ALL withdrawals, you must supply the Withdrawal Type, the Wallet and the Amount.
For CRYPTOCURRENCY withdrawals, you will also supply the Address where the funds should be sent. If it is a Monero transaction, you can also include a Payment ID. If it is an EOS transaction you can specify the Memo using the Payment ID field.
For WIRE WITHDRAWALS, you will need to fill in the beneficiary bank information.
In some cases your bank will require the use of an intermediary bank, if this is the case, please supply those fields as well.
When submitting a Ripple Withdrawal via API, you should include tag in the payment_id field

Response Details

Key	Type	Description
status	[string]	“success” or “error”.
message	[string]	Success or error message
withdrawal_id	[int]	ID of the withdrawal (0 if unsuccessful)

Withdrawal Types
"bitcoin", "litecoin", "ethereum", "ethereumc", "tetheruso", "tetheruse", "tetherusl", "tetherusx", "tetheruss", "wire", "zcash", "monero", "dash", "ripple", "iota", "eos", "santiment", "omisego", "bcash", "neo", "metaverse", "qtum", "aventus", "eidoo", "bgold", "datacoin", "qash", "yoyow", "golem", "status", "bat", "mna", "fun", "zrx", "tnb", "spk", "trx", "rcn", "rlc", "aid", "sng", "rep", "elf", "nec", "ios", "aio", "req", "rdn", "lrc", "wax", "dai", "cfi", "agi", "bft", "mtn", "ode", "ant", "dth", "mit", "stj", "xlm", "xvg", "bci", "mkr", "ven", "knc", "poa", "lym", "utk", "vee", "dad", "ors", "auc", "poy", "fsn", "cbt", "zcn", "sen", "nca", "cnd", "ctx", "pai", "see", "ess", "atd", "add", "mto", "atm", "hot", "dta", "iqx", "wpr", "zil", "bnt", "abs", "xra", "man", "xtz"

Notes on the Tether withdraw types:
Each Tether type represents a transport layer as follows:
"tetheruso" -> Tether on Omni
"tetheruse" -> Tether on ERC20
"tetherusl" -> Tether on Liquid
"tetherusx" -> Tether on Tron
"tetheruss" -> Tether on EOS
"tetherusdtalg" -> Tether on Algorand

For an up-to-date listing of supported currencies see: https://api.bitfinex.com/v2/conf/pub:map:currency:label

Query Params

withdraw_type

string

required

defines the currency your are trying to withdraw, see the "Withdrawal Types" section below for accepted values

walletselected

string

required

The wallet to withdraw from, can be “trading”, “exchange”, or “deposit”.

amount

string

required

Amount to withdraw.

address

string

(1) Destination address for withdrawal. (Not used when withdraw_type=wire)

currency

string

Defaults to "USD"

Desired currency for wire requests (USD|EUR|JPY|GPB)

payment_id

string

Optional hex string for currencies that require a memo, tag, or ID..

account_name

string

Account name

account_number

string

Account number

account_address

string

Account address

swift

string

The SWIFT code for your bank.

bank_name

string

Bank name

bank_address

string

Bank address

bank_city

string

Bank city

bank_country

string

Bank country

detail_payment

string

Message to beneficiary

expressWire

int32

“1” to submit an express wire withdrawal, “0” or omit for a normal withdrawal

intermediary_bank_name

string

Intermediary bank name

intermediary_bank_address

string

Intermediary bank address

intermediary_bank_city

string

Intermediary bank city

intermediary_bank_country

string

Intermediary bank country

intermediary_bank_account

string

Intermediary bank account

intermediary_bank_swift

string

Intermediary bank SWIFT

travel_rule_tos

boolean

Flag to voluntarily send travel rule details for crypto withdrawal

vasp_did

string

Virtual asset provider identifier, optional info for travel rule purpose. DID values can be found on https://api-pub.bitfinex.com/v2/ext/vasps endpoint.

vasp_name

string

Virtual asset provider name, optional info for travel rule purpose, if self custody ignore the field

beneficiary_self

boolean

Set to 'true' to extract destination data from your KYC data. (If 'true', dest_firstname, dest_lastname, or dest_corp_name do not need to be supplied)

dest_firstname

string

Destination entity first name for travel rule purpose (mandatory if dest_lastname is supplied, not required if beneficiary_self = true)

dest_lastname

string

Destination entity last name for travel rule purpose (mandatory if dest_firstname is supplied, not required if beneficiary_self = true)

dest_corp_name

string

Destination entity corporate name for travel rule purpose. (use either dest_firstname + dest_lastname or dest_corp_name, not required if beneficiary_self = true)

Responses

Note

200200

400400