get
https://{region}-api.upbit.com/v1/orders/closed
Retrieves the list of closed orders.
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
You can retrieve the list of closed orders for your account. Closed orders include fully filled orders and canceled orders. Optionally, you can filter by market pair, order status (such as pending trades or reserved orders), and query period to obtain closed orders matching the specified criteria. When specifying the query period, a maximum window of 7 days can be requested.
The parameters
Please use only one of these parameters when filtering by order status according to your criteria.
state and states[] cannot be used simultaneously.
| Version | Date | Changes |
|---|---|---|
| v1.2.1 | 2025-07-02 |
Addition of Self-Match Prevention (SMP) feature
|
| v1.1.9 | 2024-12-18 |
Support for start_time and end_time in timestamp format
|
| v1.1.9 | 2024-12-04 |
Addition of identifier field
|
| v1.1.6 | 2024-10-02 |
Change in default query range, Maximum of 7 days |
| v1.1.4 | 2024-06-19 |
Addition of List Closed Orders
|
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 permission error, please verify the permission settings in the API Key Management page.
If you encounter an out_of_scope permission error, please verify the permission settings in the API Key Management page.