체결 대기 주문 목록 조회

체결 대기 중인 주문(Open Orders) 목록을 조회합니다.

포켓의 체결 대기 주문 목록을 조회할 수 있습니다. 필터 파라미터인 페어와 주문 상태(체결 대기 또는 예약 주문 대기)를 선택적으로 입력하여 해당 조건을 만족하는 체결 대기 주문들을 조회할 수 있습니다.

state와 states[]는 동시에 사용할 수 없습니다.
주문 상태 필터링 시 조건에 따라 적절한 파라미터를 하나만 사용해주세요.
Rate Limit

초당 최대 30회 호출할 수 있습니다. 포켓 단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.


API Key Permission
인증이 필요한 API로, [주문조회] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.

Query Params
string

조회하고자 하는 페어(거래쌍)

string
enum
Defaults to wait

대기 주문 상태.

  • wait: 체결 대기
  • watch: 예약 주문 대기
Allowed:
states[]
array of strings
Defaults to wait

주문의 상태 (배열 형식).
사용 가능한 값은 "wait"(체결 대기), "watch"(예약 주문 대기)입니다. 미지정시 기본값은 ["wait"]입니다.

[예시] states[]=wait&states[]=watch

states[]
Allowed:
integer
Defaults to 1

조회할 페이지 번호. 미지정시 기본값은 1입니다.

integer
Defaults to 100

요청 개수(default: 100, max: 100)

string
enum
Defaults to desc

결과 정렬 방식. "desc"(최신 주문 순) 또는 "asc"(오래된 주문 순). 기본값은 "desc"입니다.

Allowed:
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.