---
title: "종료 주문 목록 조회"
method: GET
path: "/orders/closed"
tags: ["주문(Order)"]
---

# 종료 주문 목록 조회

`GET /orders/closed`

종료 주문(Closed Order) 목록을 조회합니다.

## Query parameters

- `market` string — 조회하고자 하는 페어(거래쌍)
- `state` 'done' | 'cancel' — 주문의 상태. - 시장가 주문이 조회되지 않는 경우: 시장가 매수 주문은 체결 후 주문 상태가 `cancel`, `done` 두 경우 모두 발생할 수 있습니다. - 시장가로 체결이 일어난 후 주문 잔량이 발생하는 경우, 남은 잔량이 반환되며 `cancel` 처리됩니다. 대부분의 경우 소수점 아래 8자리까지 나누어떨어지지 않는 미미한 금액이 주문 잔량으로 발생하게 됩니다. - 만일 주문 잔량 없이 딱 맞아떨어지게 체결이 발생한 경우에는 주문 상태가 `done`이 됩니다.
- `states[]` string[] — 주문의 상태. 지정한 상태의 주문만을 조회하기 위한 필터 파라미터입니다. 배열 형식이며 사용 가능한 값은 “done”(주문 전체 체결 완료), “cancel”(주문 전체 또는 부분 취소)입니다. 미지정시 기본값은 모든 상태(done, cancel)의 주문 반환입니다. [예시] states[]=done&states[]=cancel
- `start_time` string — 조회 기간의 시작 시각. 지정한 시간 범위 내에 생성된 주문만 조회하기 위한 필터 파라미터입니다. 지정한 시각으로부터 “end_time”에 지정한 시각까지 생성된 주문을 조회 대상으로 한정합니다. 조회 가능 범위는 최대 7일입니다. * “start_time”만 입력하는 경우 해당 시각 기준으로 이후 7일, 두 필드 모두 미입력시 요청 시각을 기준으로 이전 7일을 조회 기간으로 적용합니다. * “start_time”, “end_time”으로 지정한 기간이 7일을 초과하는 경우 최대 허용 범위 초과 에러가 발생합니다. * 조회 시간 내의 주문 건이라도 limit 개수를 초과한 범위일 경우 조회되지 않으니 이 경우 나누어서 조회하여야 합니다. 다음 중 하나의 형식으로 입력할 수 있습니다. * ISO 8601 형식 (타임존 포함) [예시] 2025-06-24T04:56:53Z 2025-06-24T13:56:53+09:00 * 밀리초 단위의 타임스탬프 [예시] 1750741013000 (UTC)
- `end_time` string — 조회 기간의 종료 시각. 지정한 시간 범위 내에 생성된 주문만 조회하기 위한 필터 파라미터입니다. “start_time” 부터 이 필드에 지정한 시각까지 생성된 주문을 조회 대상으로 한정합니다. 조회 가능 범위는 최대 7일입니다. * “end_time”만 입력하는 경우 해당 시각 기준으로 이전 7일, 두 필드 모두 미입력시 요청 시각을 기준으로 이전 7일을 조회 기간으로 적용합니다. * “start_time”, “end_time”으로 지정한 기간이 7일을 초과하는 경우 최대 허용 범위 초과 에러가 발생합니다. 다음 중 하나의 형식으로 입력할 수 있습니다. * ISO 8601 형식 (타임존 포함) [예시] 2025-06-24T04:56:53Z 2025-06-24T13:56:53+09:00 * 밀리초 단위의 타임스탬프 [예시] 1750741013000 (UTC)
- `limit` integer — 요청 개수(default: 100, max: 1,000) 요청 당 조회할 주문 개수를 지정합니다. 주문 조회 가능한 최대 개수는 1,000개이며, 시간 범위 내 주문 개수가 1,000개가 넘어갈 경우 시간 범위를 나누어 조회하여야 합니다.
- `order_by` 'asc' | 'desc' — 결과 정렬 방식. 주문 생성 시각을 기준으로 설정한 방식에 따라 정렬된 주문 목록이 반환됩니다. 사용 가능한 값은 “desc”(내림차순, 최신 주문 순) 또는 “asc”(오름차순, 오래된 주문 순)입니다. 기본값은 “desc”입니다.

## Response `200`

List of closed orders

- object[]
  - `market` string, required — 페어(거래쌍)의 코드 [예시] "KRW-BTC"
  - `uuid` string, required — 주문의 유일 식별자
  - `side` 'ask' | 'bid', required — 주문 방향(매수/매도)
  - `ord_type` 'limit' | 'price' | 'market' | 'best', required — 주문 유형. - `limit`: 지정가 매수/매도 주문 - `price`: 시장가 매수 주문 - `market`: 시장가 매도 주문 - `best`: 최유리 지정가 매수/매도 주문 (time_in_force 필드 설정 필수)
  - `price` string, required — 주문 단가 또는 총액 지정가 주문의 경우 단가, 시장가 매수 주문의 경우 매수 총액입니다.
  - `state` 'done' | 'cancel', required — 주문 상태 - `done`: 체결 완료 - `cancel`: 주문 취소
  - `created_at` string, required — 주문 생성 시각 (KST 기준) [형식] yyyy-MM-ddTHH:mm:ss+09:00
  - `volume` string, required — 주문 요청 수량
  - `remaining_volume` string, required — 체결 후 남은 주문 양
  - `executed_volume` string, required — 체결된 양
  - `executed_funds` string, required — 현재까지 체결된 금액
  - `reserved_fee` string, required — 수수료로 예약된 비용
  - `remaining_fee` string, required — 남은 수수료
  - `paid_fee` string, required — 사용된 수수료
  - `locked` string, required — 거래에 사용 중인 비용
  - `time_in_force` 'fok' | 'ioc' | 'post_only' — 주문 체결 옵션
  - `identifier` string — 주문 생성시 클라이언트가 지정한 주문 식별자. * identifier 필드는 2024년 10월 18일 이후 생성된 주문에 대해서만 제공됩니다.
  - `smp_type` 'reduce' | 'cancel_maker' | 'cancel_taker' — 자전거래 체결 방지(Self-Match Prevention) 모드
  - `prevented_volume` string, required — 자전거래 방지로 인해 취소된 수량. 동일 사용자의 주문 간 체결이 발생하지 않도록 설정(SMP)에 따라 취소된 주문 수량입니다.
  - `prevented_locked` string, required — 자전거래 방지로 인해 해제된 자산. 자전거래 체결 방지 설정으로 인해 취소된 주문의 잔여 자산입니다. - 매수 주문의 경우: 취소된 금액 - 매도 주문의 경우: 취소된 수량
  - `trades_count` integer, required — 해당 주문에 대한 체결 건수

## Other responses

- `400` — error object

---

[API](https://skmtc.net/upbit/apis/quotation-api.md) · [All operations](https://skmtc.net/upbit/apis/quotation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upbit/quotation-api/versions/b8bd8b9ed3b5/schema)