List Withdrawal Allowed Addresses

Retrieves the list of withdrawal whitelist addresses registered to the account.

Check the proper endpoint based on your region.
The base_url differs by country/region. Make sure to specify the correct region value for your environment.

- 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.

Network Type(net_type) and Network Name(network_name)
The network type(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.
Some response fields may return null depending on the type of withdrawal whitelist address.
[Differences in Response Fields by Address Type]
  • For personal wallet addresses, the 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.
  • For exchange wallets, the 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]
  • For individual-owned addresses, the beneficiary_type returns individual, and the beneficiary_company_name field returns null.
  • For corporate-owned addresses, the beneficiary_type returns corporate, and the beneficiary_company_name field returns the name of the corporation.

  • Rate Limit
    Up to 30 calls per second are allowed. This is measured on an account basis and request counts are shared within the exchange 'default' group.

    API Key Permission
    This API requires authentication and an API Key with [View Withdrawals] permission.
    If you encounter an out_of_scope permission error, please check your permissions in the API Key Management page.
    Language
    URL