종료 주문 목록 조회

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

포켓의 종료 주문 목록을 조회할 수 있습니다. 종료 주문은 전량 체결 주문과 취소 주문을 포함합니다. 필터 파라미터인 페어와 주문 상태(체결 완료 또는 주문 취소), 조회 기간을 선택적으로 입력하여 해당 조건을 만족하는 종료 주문들을 조회할 수 있습니다. 조회 기간을 정하는 경우 최대 7일 구간(window)을 조회할 수 있습니다.

state와 states[]는 동시에 사용할 수 없습니다.
주문 상태 필터링 시 조건에 따라 적절한 파라미터를 하나만 사용해주세요.
Rate Limit
초당 최대 30회 호출할 수 있습니다. 포켓 단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.

API Key Permission
인증이 필요한 API로, [주문조회] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.

Query Params
string

조회하고자 하는 페어(거래쌍)

string
enum
Defaults to done,cancel

주문의 상태.

  • 시장가 주문이 조회되지 않는 경우: 시장가 매수 주문은 체결 후 주문 상태가 cancel, done 두 경우 모두 발생할 수 있습니다.
  • 시장가로 체결이 일어난 후 주문 잔량이 발생하는 경우, 남은 잔량이 반환되며 cancel 처리됩니다. 대부분의 경우 소수점 아래 8자리까지 나누어떨어지지 않는 미미한 금액이 주문 잔량으로 발생하게 됩니다.
  • 만일 주문 잔량 없이 딱 맞아떨어지게 체결이 발생한 경우에는 주문 상태가 done이 됩니다.
Allowed:
states[]
array of strings
Defaults to done,cancel

주문의 상태.
지정한 상태의 주문만을 조회하기 위한 필터 파라미터입니다. 배열 형식이며 사용 가능한 값은 “done”(주문 전체 체결 완료), “cancel”(주문 전체 또는 부분 취소)입니다. 미지정시 기본값은 모든 상태(done, cancel)의 주문 반환입니다.

[예시] states[]=done&states[]=cancel

states[]
Allowed:
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)

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)

integer
Defaults to 100

요청 개수(default: 100, max: 1,000)
요청 당 조회할 주문 개수를 지정합니다. 주문 조회 가능한 최대 개수는 1,000개이며, 시간 범위 내 주문 개수가 1,000개가 넘어갈 경우 시간 범위를 나누어 조회하여야 합니다.

string
enum
Defaults to desc

결과 정렬 방식.
주문 생성 시각을 기준으로 설정한 방식에 따라 정렬된 주문 목록이 반환됩니다. 사용 가능한 값은 “desc”(내림차순, 최신 주문 순) 또는 “asc”(오름차순, 오래된 주문 순)입니다. 기본값은 “desc”입니다.

Allowed:
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.