Retrieves the list of withdrawal whitelist addresses registered to the account.
- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com
Withdrawal Whitelist Address Registration
To request the withdrawal, a withdrawal address must be registered.
Please refer to the Withdrawal Allowlist Registration Guide and register your withdrawal allowlist address through the [My Page > Open API Management > Digital Asset Withdrawal Address Management] menu on the Upbit PC Web.
Address Verification under Travel Rule Compliance
When registering a withdrawal whitelist address, Upbit requests address verification from the counterparty exchange that issued the address to comply with the Travel Rule. If the counterparty exchange does not receive, approve, or if verification fails, withdrawals may be restricted. Therefore, before registering a withdrawal whitelist address, please ensure that the address is supported by the relevant exchange.
net_type
) and Network Name(network_name
)
net_type
) is an identifier field used to specify the blockchain network (target chain) through which a digital asset is transferred during deposit and withdrawal (e.g., BTC
). It is a required parameter for digital asset withdrawals, and the correct identifier value must be used to ensure proper processing. When calling the withdrawal API, you should first call the withdrawal whitelist address API and use the exact network type value from the response.
The network name(
network_name
) represents the full name of the blockchain network (e.g., Bitcoin
). It is human-readable information and cannot be used as an identifier. It is intended for display purposes, such as representing the blockchain network in a service UI.
beneficiary_name
field returns the member's name, and the wallet_type
field returns the personal wallet name. The exchange_name
and beneficiary_type
fields return null.
exchange_name
field returns the name of the exchange owning the wallet, and the beneficiary_name
field returns the member's name. The wallet_type
field returns null. The beneficiary_type
is returned according to the owner type as described below.
[Differences in Response Fields by Address Owner Type]
beneficiary_type
returns individual
, and the beneficiary_company_name
field returns null.
beneficiary_type
returns corporate
, and the beneficiary_company_name
field returns the name of the corporation.
Version | Date | Changes |
---|---|---|
v1.2.1 | 2025-07-07 |
Addition of new response fieldsexchange_name , wallet_type , beneficiary_type , beneficiary_name , beneficiary_company_name
|
v1.0.7 | 2023-05-23 |
Addition of net_type field
|
If you encounter an out_of_scope permission error, please check your permissions in the API Key Management page.