List Withdrawals

get

https://{region}-api.upbit.com/v1/withdraws

Retrieves latest withdrawal list.

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

You can set query parameters to retrieve a filtered list of withdrawals that meet the specified conditions. Currency, withdrawal status, UUID list, or TXID list can be used as filter parameters. If no conditions are specified, the API returns the most recent 100 withdrawal records.

Revision History

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

This API requires authentication and an API Key with [View Withdrawals] permission.
If you receive an out_of_scope permission error, please verify your API Key permissions in the API Key Management page.

Query Params

currency

string

Currency code filter.
If not specified, all currencies are returned.

state

string

enum

Withdrawal state filter.

WAITING: Waiting
PROCESSING: Processing
DONE: Completed
FAILED: Failed
CANCELLED: Cancelled
REJECTED: Rejected

Allowed:

uuids[]

array of strings

List of UUIDs to query. Maximum 100. Cannot be used together with txids.

[Example] uuids[]=uuid1&uuids[]=uuid2

uuids[]

txids[]

array of strings

List of transaction IDs to query. Maximum 100. Cannot be used together with uuids.

[Example] txids[]=txid1&txids[]=txid2

txids[]

limit

integer

Defaults to 100

Number of results per request (default: 100, max: 100).

page

integer

Defaults to 1

Page number for pagination. Default is 1.

order_by

string

enum

Defaults to desc

Sort order. "desc" (newest first) or "asc" (oldest first). Default is "desc".

Allowed:

from

string

Cursor for pagination.
Enter a "uuid" from the response to retrieve "limit" withdrawals after that timestamp.

string

Cursor for pagination.
Enter a "uuid" from the response to retrieve "limit" withdrawals before that timestamp.

Responses

200List of withdrawals

400error object

401error object