종료된 주문 (Closed Order) 조회

주문 상태

done : 전체 체결 완료
cancel : 주문 취소

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

주문 상태의 목록, default: ['done', 'cancel']

*기본값은 done, cancel 둘 다 조회됩니다.
* state와 states는 동시에 사용할 수 없습니다. 둘 중 하나만 지정하시기를 바랍니다.

조회 시작 시각 (주문 생성시각 기준)

• start_time 과 end_time 은 Time Zone 이 포함된 ISO-8601 포맷(ex. 2024-12-09T13:56:53+09:00) 혹은 밀리세컨드 단위의 Timestamp(ex.1733720213791) 여야 합니다.
• start_time, end_time이 둘 다 정의되지 않은 경우 현재 시각으로부터 최대 7일 전까지의 주문이 조회됩니다.
• start_time만 정의한 경우 start_time으로부터 최대 7일 후까지의 주문이 조회됩니다.
• end_time만 정의한 경우 end_time으로부터 최대 7일 전까지의 주문이 조회됩니다.
• start_time과 end_time을 둘 다 정의할 경우 최대 7일 범위까지의 주문만 조회가 가능합니다.
• *조회 시간 내의 주문 건이라도 limit 개수를 초과한 범위일 경우 조회되지 않으니 이 경우 나누어서 조회하여야 합니다.

요청 개수, default: 100, max: 1,000

• 주문 조회 가능한 최대 개수는 1,000개이며, 시간 범위 내 주문 개수가 1,000개가 넘어갈 경우 시간 범위를 나누어 조회하여야 합니다.

정렬 방식

• asc : 오름차순
• desc : 내림차순 (default)

주문 방식

• limit : 지정가 주문
• price : 시장가 주문(매수)
• market : 시장가 주문(매도)
• best : 최유리 주문

주문 상태

• done : 전체 체결 완료
• cancel : 주문 취소

조회용 사용자 지정값

*identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다.