HomeGuidesAPI ReferenceAnnouncements
AnnouncementsGuidesAPI ReferenceSupportFAQ
API Reference

주문 리스트 조회

주문 리스트를 조회한다.

❗️

Deprecated (2024.06~)

GET v1/orders 를 사용중이실 경우, 용도에 따라 v1/orders/uuids ,v1/orders/open ,v1/orders/closed로 변경해주시기 바랍니다.
정확한 지원종료 예정일은 추후 공지사항을 통해 다시 안내드리겠습니다.

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에서 시장가 주문이 조회되지 않는경우: 시장가 매수 주문은 체결 후 주문 상태가 canceldone 두 경우 모두 발생할 수 있습니다.

- 시장가로 체결이 일어난 후 주문 잔량이 발생하는 경우, 남은 잔량이 반환되며 cancel 처리됩니다. 대부분의 경우 소수점 아래 8자리까지 나누어 떨어지지 않는 미미한 금액이 주문 잔량으로 발생하게 됩니다.

- 만일 주문 잔량 없이 딱 맞아떨어지게 체결이 발생한 경우에는 주문 상태가 done이 됩니다.
String
states주문 상태의 목록

* 미체결 주문(wait, watch)과 완료 주문(done, cancel)은 혼합하여 조회하실 수 없습니다.
* state와 states는 동시에 사용할 수 없습니다. 둘 중 하나만 지정하시기를 바랍니다.
Array
page페이지 수, default: 1Number
limit요청 개수, default: 100Number
order_by정렬 방식

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

Response

📘

신규 주문 타입 및 조건 지원 (지원 마켓은 공지참고)

  • 신규 주문 타입이 추가되었습니다: 최유리 지정가 (ord_type 필드에 best 타입 추가)

  • 신규 주문 조건이 추가 되었습니다: IOC (Immediate or Cancel), FOK (Fill or Kill)

    • time_in_force 필드가 신규로 추가되며, 가능한 타입은 iocfok입니다.

필드설명타입
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
time_in_forceIOC, FOK 설정String
Language