get
https://api.upbit.com/v1/orders/closed
종료 주문(Closed Order) 목록을 조회합니다.
포켓의 종료 주문 목록을 조회할 수 있습니다. 종료 주문은 전량 체결 주문과 취소 주문을 포함합니다. 필터 파라미터인 페어와 주문 상태(체결 완료 또는 주문 취소), 조회 기간을 선택적으로 입력하여 해당 조건을 만족하는 종료 주문들을 조회할 수 있습니다. 조회 기간을 정하는 경우 최대 7일 구간(window)을 조회할 수 있습니다.
state와 states[]는 동시에 사용할 수 없습니다.
주문 상태 필터링 시 조건에 따라 적절한 파라미터를 하나만 사용해주세요.
| 반영 버전 | 반영 일자 | 변경 사항 |
|---|---|---|
| v1.5.8 | 2025-07-02 | 자전거래 체결 방지(SMP) 기능 신규 지원에 따른 필드 추가 smp_type,prevented_volume,prevented_locked |
| 2024-12-18 | start_time, end_time 파라미터 timestamp 형식 추가 지원 | |
| 2024-12-04 | identifier 필드 신규 지원 | |
| 2024-10-02 | 주문 조회 가능 범위 7일로 확대 지원 | |
| 2024-06-27 | '종료 주문 목록 조회' 신규 기능 지원 |
Rate Limit
초당 최대 30회 호출할 수 있습니다. 포켓 단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.
API Key Permission
인증이 필요한 API로, [주문조회] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.