get
https://{region}-api.upbit.com/v1/orders/uuids
Retrieves orders by a list of UUIDs or Identifiers.
Check the proper endpoint based on your region.
The examples in this page is written using Singapore fiat code(SGD). Set the quote currency to match 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
Use this API to retrieve a list of orders when you already know their UUIDs or Identifiers. You can also optionally provide the pair filter parameter to restrict the results to orders from a specific trading pair.
To retrieve the complete order history for a specific trading pair without providing order identifiers, or to apply time-based query criteria, you can use the List Open Orders API or the List Closed Orders API.
The request must include either
Both parameters are optional, but at least one must be included to specify the orders to query. You cannot use both parameters simultaneously.
uuid[] or identifier[].
| Version | Date | Changes |
|---|---|---|
| v1.2.1 | 2025-07-02 |
Addition of Self-Match Prevention (SMP) feature
|
| v1.1.9 | 2024-12-04 |
Addition of identifier field
|
| v1.1.6 | 2024-10-02 | Order List Inquiry Deleted |
| v1.1.4 | 2024-06-19 |
Order List Inquiry Deprecated (planned), Addition of List Orders
|
| v1.1.1 | 2024-04-22 |
Addition of ord_type: best,Addition of time_in_force parameter(All Markets) |
| v1.1.1 | 2024-04-04 |
Addition of ord_type: best,Addition of time_in_force parameter(BTC Market Upbit Indonesia and Thailand) |
| v1.1.1 | 2024-02-26 |
Addition of ord_type: best,Addition of time_in_force parameter(THB, IDR Market Upbit Indonesia and Thailand) |
| v1.1.1 | 2023-10-27 |
Addition of ord_type: best,Addition of time_in_force parameter(Upbit Singapore only) |
| v1.0.3 | 2021-03-22 |
Addition of 'wait, watch' and 'done, cancel' parameters
|
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 Orders] permission must be used.
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.