Withdraw Digital Asset

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 Allowed Address Registration

When withdrawing digital assets via API, the withdrawal destination address must be pre-registered as an allowed withdrawal address. Withdrawal allowed addresses can be registered through the Upbit website, and registration via API is not supported. Please refer to the How to Register Withdrawal Allowed Address page for instructions on registering withdrawal allowed addresses.

Transaction Types — Regular Withdrawal (default) and Instant Withdrawal (internal)

When withdrawing digital assets to a personal wallet address or an external exchange wallet address, the withdrawal proceeds as a regular withdrawal. Regular withdrawals involve actual blockchain transactions, which include processing times due to transaction confirmation and incur withdrawal fees.

For transfers between Upbit accounts, instant withdrawal can be used. Instant withdrawal does not utilize the blockchain, reflecting the withdrawal within approximately one minute without any fees. Instant withdrawals must be sent to an Upbit member’s wallet address; requests to addresses not registered as Upbit member addresses will not be processed correctly.

For detailed information about regular and instant withdrawals, please refer to Upbit Customer Center - Frequently Asked Questions.

Network Type (net_type) is a required parameter.

Network Type (net_type) is an identifier field used to specify the blockchain network (target chain) on which the actual digital asset transfer occurs during deposit and withdrawal (e.g., BTC). It is a mandatory parameter when withdrawing digital assets, and the correct identifier value must be used to ensure proper processing of deposits and withdrawals. When calling the digital asset withdrawal API, please first call the Withdrawal Allowed Address List API and refer to the accurate network type value from the response for use.

Form-based POST requests are no longer supported from March 1, 2022.

Due to the end of Form support, POST requests sent using URL-encoded Form data are no longer guaranteed to work properly. Please ensure that the request body is sent strictly in JSON format.

Revision History

Version	Date	Changes
	2022-04-29	Addition of `beneficiary` parameter (Upbit Indonesia only)

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 [Withdraw] permission.
If you receive an out_of_scope permission error, please verify your API Key permissions in the API Key Management page.