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