get https://api.upbit.com/v1/orders
주문 리스트를 조회한다.
Request Parameters
states 파라미터 변경 안내 (2021. 03. 22 ~)
2021년 3월 22일부터 미체결 주문(wait, watch)과 완료 주문(done, cancel)을 혼합하여 조회하실 수 없습니다.
예시1) done, cancel 주문을 한 번에 조회 => 가능
예시2) wait, done 주문을 한 번에 조회 => 불가능 (각각 API 호출 필요)자세한 내용은 개발자 센터 공지사항을 참조 부탁드립니다.
Name | 설명 | 타입 |
---|---|---|
market | 마켓 아이디 | String |
uuids | 주문 UUID의 목록 | Array |
identifiers | 주문 identifier의 목록 | Array |
state | 주문 상태 - wait : 체결 대기 (default)- watch : 예약주문 대기- done : 전체 체결 완료- cancel : 주문 취소- 주문 리스트 조회 API에서 시장가 주문이 조회되지 않는경우: 시장가 매수 주문은 체결 후 주문 상태가 cancel , done 두 경우 모두 발생할 수 있습니다.- 시장가로 체결이 일어난 후 주문 잔량이 발생하는 경우, 남은 잔량이 반환되며 cancel 처리됩니다. 대부분의 경우 소수점 아래 8자리까지 나누어 떨어지지 않는 미미한 금액이 주문 잔량으로 발생하게 됩니다.- 만일 주문 잔량 없이 딱 맞아떨어지게 체결이 발생한 경우에는 주문 상태가 done 이 됩니다. | String |
states | 주문 상태의 목록 * 미체결 주문(wait, watch)과 완료 주문(done, cancel)은 혼합하여 조회하실 수 없습니다. | Array |
page | 페이지 수, default: 1 | Number |
limit | 요청 개수, default: 100 | Number |
order_by | 정렬 방식 - asc : 오름차순- desc : 내림차순 (default) | String |
Response
필드 | 설명 | 타입 |
---|---|---|
uuid | 주문의 고유 아이디 | String |
side | 주문 종류 | String |
ord_type | 주문 방식 | String |
price | 주문 당시 화폐 가격 | NumberString |
state | 주문 상태 | String |
market | 마켓의 유일키 | String |
created_at | 주문 생성 시간 | DateString |
volume | 사용자가 입력한 주문 양 | NumberString |
remaining_volume | 체결 후 남은 주문 양 | NumberString |
reserved_fee | 수수료로 예약된 비용 | NumberString |
remaining_fee | 남은 수수료 | NumberString |
paid_fee | 사용된 수수료 | NumberString |
locked | 거래에 사용중인 비용 | NumberString |
executed_volume | 체결된 양 | NumberString |
trades_count | 해당 주문에 걸린 체결 수 | Integer |