get https://api.upbit.com/v1/orders/closed
종료된 주문 (Closed Order) 리스트를 조회한다.
Request Parameters
해당 API를 통해 종료된 상태(done, cancel)인 주문을 조회할 수 있습니다.
- uuid 또는 identifiers 기준 조회가 필요시
v1/orders/uuids를 이용해 주세요.- 체결 대기 주문 조회 필요시
v1/orders/open을 이용해 주세요.
| Name | 설명 | 타입 |
|---|---|---|
| market | 마켓 ID | String |
| 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-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 개수를 초과한 범위일 경우 조회되지 않으니 이 경우 나누어서 조회하여야 합니다. | 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 | 마켓 ID | String |
| 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_force | IOC, FOK 설정 - ioc : Immediate or Cancel- fok : Fill or Kill | String |
| identifier | 조회용 사용자 지정값 *identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다. | String |
*null인 필드는 응답에서 제외됩니다. (예: IOC or FOK 설정이 없었던 주문의 경우 해당 필드는 응답되지 않습니다.