GuidesAPI ReferenceRecipesAnnouncementsSupport
API Reference

List Closed Orders

get
https://{region}-api.upbit.com/v1/orders/closed

Retrieves the list of closed orders.

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[]
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 7 months ago

Language
URL
Request
Response 
 Choose an example:
application/json
Updated 7 months ago