GuidesAPI ReferenceRecipesAnnouncementsSupport
API Reference
GitHub

List Closed Orders

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

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 state and states[] cannot be used simultaneously.
Please use only one of these parameters when filtering by order status according to your criteria.

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.
Query Params
string

Trading pair code representing the market.

string
enum
Defaults to done,cancel

Status of the order.

  • When a market order is not returned: After execution, a market buy order can have a status of either cancel or done.
  • If there is any remaining quantity after a market order is executed, the remaining amount is returned and the order status is set to cancel. In most cases, a small remainder occurs due to rounding, as the filled amount may not be divisible exactly to eight decimal places.
  • If the order is fully filled with no remaining quantity, the order status is set to done.
Allowed:
states[]
array of strings
Defaults to done,cancel

Status of the order.
A filter parameter used to retrieve only orders with the specified status. This parameter is in array format, and the available values are "done" (order fully executed) and "cancel" (order fully or partially canceled). If not specified, orders of all statuses (done, cancel) will be returned.

[Example] states[]=done&states[]=cancel

states[]
Allowed:
string

Start time of the query period.
Only orders created within the specified time range are returned. Maximum range is 7 days.

  • If only start_time is specified, the query period will span 7 days starting from that time.
  • If neither start_time nor end_time is specified, the default query period is the 7 days preceding the time of the request.
  • If the duration between start_time and end_time exceeds 7 days, an error will occur due to exceeding the maximum allowed range.

Can be specified as:

  • ISO 8601 format with timezone
    [Example]
    2025-06-24T04:56:53Z (UTC),
    2025-06-24T13:56:53+08:00 (SGT)
  • Timestamp in milliseconds
    [Example]
    1750741013000 (UTC)
string

End time of the query period.
Only orders created from "start_time" up to this time are returned. Maximum range is 7 days.

  • If only end_time is specified, the query period will cover the 7 days preceding that time.
  • If neither start_time nor end_time is provided, the default query period is the 7 days prior to the time of the request.

Can be specified as:

  • ISO 8601 format with timezone
    [Example]
    2025-06-24T04:56:53Z (UTC),
    2025-06-24T13:56:53+08:00 (SGT)
  • Timestamp in milliseconds
    [Example]
    1750741013000 (UTC)
integer
Defaults to 100

Number of items per page.
A parameter for pagination that allows you to specify the number of items per page to retrieve. Up to 1,000 items can be retrieved at a time, and if not specified, the default value is 100.

string
enum
Defaults to desc

Sorting method for query results.
Returns a list of orders sorted according to the specified method based on the order creation time.
The available values are "desc" (descending, latest orders first) or "asc" (ascending, oldest orders first).
The default value is "desc".

Allowed:
Responses

Updated 10 months ago

Language
URL
LoadingLoading…
Response
Choose an example:
application/json

Updated 10 months ago