get https://{region}-api.upbit.com/v1/order
Retrieves an order information by order UUID or Identifier.
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
One of `uuid` or `identifier` must be included in the query request.
Although both parameters are optional, at least one must be included to specify the order to be queried. If both `uuid` and `identifier` are provided, the query will be based on the `uuid`.
| 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.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) |
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.