체결 대기 주문 목록 조회

체결 대기 중인 주문(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”(예약 주문 대기)입니다. 미지정시 기본값은 “wait”입니다.

Allowed:
states[]
array of strings
Defaults to wait

주문의 상태.
지정한 상태의 주문만을 조회하기 위한 필터 파라미터입니다. 배열 형식이며 사용 가능한 값은 “wait”(체결 대기), “watch”(예약 주문 대기)입니다. 미지정시 기본값은 “wait”입니다.

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

states[]
Allowed:
integer
Defaults to 1

조회할 페이지 번호.
Pagination을 위한 파라미터로, 조회하고자 하는 페이지를 지정할 수 있습니다. 미지정시 기본값은 1입니다.

integer
Defaults to 100

요청 개수(default: 100, max: 100)
요청 당 조회할 주문 개수를 지정합니다. 한번에 최대 100개의 항목을 조회할 수 있으며, 미지정시 기본값은 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.