v1

latestOpenAPI 3.0.12026-07-24510443.1 KB

주문(Order)

주문 일괄 취소 접수

조건을 지정하여 해당 조건을 만족하는 최대 300개의 주문을 일괄 취소합니다.

delete/orders/open

Query parameters

quote_currenciesstring

주문 취소 대상 마켓 목록. 디지털 자산 구매에 사용되는 통화(KRW,BTC,USDT)로 취소 대상 주문을 한정할 수 있는 필터 파라미터입니다. 지정한 마켓에 속한 미체결 주문을 일괄 취소합니다.

[예시] “KRW”로 지정시 원화마켓의 모든 미체결 매수 주문 취소

Example:KRW

cancel_side'bid' | 'ask' | 'all'

취소하고자 하는 주문의 매수/매도 방향 구분. 매수/매도 구분으로 취소 대상을 한정할 수 있는 필터 파라미터입니다. 사용 가능한 값은 “all”(매수, 매도 전체), “ask”(매도), “bid”(매수)입니다.

[예시] “ask”로 설정시 체결 대기중인 매도 주문을 일괄 취소합니다.

countinteger

취소할 주문의 최대 개수. 필터 파라미터들의 조합으로 한정된 대상 주문의 수가 count보다 많은 경우, 정렬 기준에 따라 count에 설정된 수만큼의 주문만 취소합니다.

최대값은 300이며 미지정시 기본값은 20입니다.

Example:300

order_by'asc' | 'desc'

취소할 주문의 정렬 방식. 주문 생성 시각을 기준으로 설정한 방식에 따라 정렬된 주문 순서에 따라 count개 주문에 대해 취소를 요청합니다.

사용 가능한 값은 “desc”(내림차순, 최신 주문 순) 또는 “asc”(오름차순, 오래된 주문 순)입니다. 기본값은 “desc”입니다.

Example:desc

pairsstring

페어(거래쌍) 목록. 주문 페어로 취소 대상을 한정할 수 있는 필터 파라미터입니다. 지정한 페어의 미체결 주문만 취소합니다. 최대 20개의 페어를 지정할 수 있으며, 2개 이상의 페어 지정시 쉼표(,)로 구분된 문자열 형식을 사용합니다.

[예시] pairs=KRW-BTC,KRW-ETH

Example:KRW-BTC,KRW-ETH

exclude_pairsstring

페어(거래쌍) 목록. 특정 페어를 제외한 모든 페어를 취소 대상 주문을 한정할 수 있는 필터 파라미터입니다. 지정한 페어의 주문을 제외한 모든 주문을 취소합니다. 최대 20개의 페어를 지정할 수 있으며, 2개 이상의 페어 지정시 쉼표(,)로 구분된 문자열 형식을 사용합니다.

[예시] pairs=KRW-BTC,KRW-ETH

Example:KRW-BTC,KRW-ETH

Response

Object of batch cancellation result

Example response

{
  "success": {
    "count": 5,
    "orders": [
      {
        "uuid": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
        "market": "KRW-BTC",
        "identifier": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae"
      }
    ]
  },
  "failed": {
    "count": 5,
    "orders": [
      {
        "uuid": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
        "market": "KRW-BTC",
        "identifier": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae"
      }
    ]
  }
}