post https://{region}-api.upbit.com/v1/deposits/generate_coin_address
Requests the creation of a deposit address for depositing assets from a personal wallet or another exchange into Upbit.
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
- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com
Differentiation of API Response Objects Due to Asynchronous Address Generation
Deposit address generation works asynchronously. Depending on the completion status at the time of the API call, two types of responses may be returned:
- Immediately after the initial request, the response shows whether the creation request was received successfully and includes only the
success
andmessage
fields. This response will continue to be returned until the address creation is finished. - After the address is generated asynchronously, the response will include the created address details:
currency
,net_type
, anddeposit_address
. An address is generated only once per currency. Subsequent creation requests will return the previously generated address.
If the deposit address is still not generated after some time, please retry the request at intervals.
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.
Version | Date | Changes |
---|---|---|
v1.0.7 | 2023-05-23 |
Addition of net_type field
|
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
API Key with authentication is required, and must have the [Deposit] permission.
If you encounter an out_of_scope error, please check the permission settings in the API Key Management page.
If you encounter an out_of_scope error, please check the permission settings in the API Key Management page.