get https://api.upbit.com/v1/orders/open
대기 주문 (Open Order) 주문 리스트를 조회한다.
Request Parameters
해당 API를 통해 대기상태(open)인 주문을 조회할 수 있습니다.
- uuid 또는 identifiers 기준 조회가 필요시
v1/orders/uuids를 이용해 주세요.- 종료된 주문 조회 필요시
v1/orders/closed를 이용해 주세요.
| Name | 설명 | 타입 |
|---|---|---|
| market | 마켓 ID | String |
| state | 주문 상태 - wait : 체결 대기 (default)- watch : 예약주문 대기 | String |
| states[] | 주문 상태의 목록 *기본값은 wait 이며, 아직 대기 상태인 예약 주문과 함께 조회하고자 하는 경우 wait, watch를 둘 다 조회해야 합니다.* state와 states는 동시에 사용할 수 없습니다. 둘 중 하나만 지정하시기를 바랍니다. | Array[String] |
| page | 페이지 수, default: 1 *페이지 당 조회건수에 대해서는 limit 파라미터로 조절할 수 있습니다. | Number |
| limit | 요청 개수, default: 100, max: 100 | Number |
| order_by | 정렬 방식 - asc : 오름차순- desc : 내림차순 (default) | String |
*default 값에 따라, 어떤 파라미터도 명시하지 않으시면 체결 대기상태의 가장 최근 주문 100개가 응답됩니다.
Response
| 필드 | 설명 | 타입 |
|---|---|---|
| uuid | 주문의 고유 아이디 | String |
| side | 주문 종류 | String |
| ord_type | 주문 방식 - limit : 지정가 주문- price : 시장가 주문(매수)- market : 시장가 주문(매도)- best : 최유리 주문 | String |
| price | 주문 당시 화폐 가격 | NumberString |
| state | 주문 상태 | String |
| market | 마켓 ID | String |
| created_at | 주문 생성 시간 | DateString |
| volume | 사용자가 입력한 주문 양 | NumberString |
| remaining_volume | 체결 후 남은 주문 양 | NumberString |
| reserved_fee | 수수료로 예약된 비용 | NumberString |
| remaining_fee | 남은 수수료 | NumberString |
| paid_fee | 사용된 수수료 | NumberString |
| locked | 거래에 사용 중인 비용 | NumberString |
| executed_volume | 체결된 양 | NumberString |
| executed_funds | 현재까지 체결된 금액 | NumberString |
| trades_count | 해당 주문에 걸린 체결 수 | Integer |
| time_in_force | IOC, FOK 설정 - ioc : Immediate or Cancel- fok : Fill or Kill | String |
| identifier | 조회용 사용자 지정값 *identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다. | String |
*null인 필드는 응답에서 제외됩니다. (예: IOC or FOK 설정이 없었던 주문의 경우 해당 필드는 응답되지 않습니다.