HomeGuidesAPI ReferenceAnnouncements
AnnouncementsGuidesAPI ReferenceSupportFAQ
API Reference

종료된 주문 (Closed Order) 조회

종료된 주문 (Closed Order) 리스트를 조회한다.

Request Parameters

📘

해당 API를 통해 종료된 상태(done, cancel)인 주문을 조회할 수 있습니다.

Name설명타입
market마켓 IDString
state주문 상태

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

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

*기본값은 done, cancel 둘 다 조회됩니다.
* state와 states는 동시에 사용할 수 없습니다. 둘 중 하나만 지정하시기를 바랍니다.
Array[String]
start_time조회 시작 시각 (주문 생성시각 기준)

- start_time 과 end_time 은 Time Zone 이 포함된 ISO-8601 포맷(ex. 2024-03-13T00:00:00+09:00) 이어야 합니다.
- start_time, end_time이 둘 다 정의되지 않은 경우 현재 시각으로부터 최대 7일 전까지의 주문이 조회됩니다.
- start_time만 정의한 경우 start_time으로부터 최대 7일 후까지의 주문이 조회됩니다.
- end_time만 정의한 경우 end_time으로부터 최대 7일 전까지의 주문이 조회됩니다.
- start_time과 end_time을 둘 다 정의할 경우 최대 7일 범위까지의 주문만 조회가 가능합니다.
- *조회 시간 내의 주문 건이라도 limit 개수를 초과한 범위일 경우 조회되지 않으니 이 경우 나누어서 조회하여야 합니다.
String
end_time조회 종료 시각 (주문 생성시각 기준)String
limit요청 개수, default: 100, max: 1,000

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

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

*default 값에 따라, 어떤 파라미터도 명시하지 않으시면 최근 7일 이내의 종료된 주문 100개가 응답됩니다.

Response

필드설명타입
uuid주문의 고유 아이디String
side주문 종류String
ord_type주문 방식

- limit : 지정가 주문
- price : 시장가 주문(매수)
- market : 시장가 주문(매도)
- best : 최유리 주문
String
price주문 당시 화폐 가격NumberString
state주문 상태String
market마켓 IDString
created_at주문 생성 시각DateString
volume사용자가 입력한 주문 양NumberString
remaining_volume체결 후 남은 주문 양NumberString
reserved_fee수수료로 예약된 비용NumberString
remaining_fee남은 수수료NumberString
paid_fee사용된 수수료NumberString
locked거래에 사용 중인 비용NumberString
executed_volume체결된 양NumberString
executed_funds현재까지 체결된 금액NumberString
trades_count해당 주문에 걸린 체결 수Integer
time_in_forceIOC, FOK 설정

- ioc : Immediate or Cancel
- fok : Fill or Kill
String

*null인 필드는 응답에서 제외됩니다. (예: IOC or FOK 설정이 없었던 주문의 경우 해당 필드는 응답되지 않습니다.

Language