id로 주문 목록 취소 접수

UUID 또는 Identifier 목록으로 취소 대상 주문을 지정 취소합니다. 한 번의 요청으로 최대 20개의 주문을 취소할 수 있습니다.

주문 취소 요청이 거절되는 경우
다음과 같은 사유로 주문 취소 요청이 거절될 수 있습니다.
  • 이미 전량 체결 완료되어 취소가 불가한 주문
  • 이미 취소가 완료된 주문
  • 해당 주문의 페어가 리브랜딩 등의 이유로 서비스를 일시 정지한 경우
  • 이 API는 쿼리 파라미터 형식만 지원합니다.
    모든 요청 파라미터는 쿼리 파라미터 형식으로만 요청할 수 있습니다. Request Body를 통한 form 형식 또는 json 형식의 파라미터 요청을 지원하지 않습니다.

    [예시] /v1/orders/uuids?uuids[]=1234567890&uuids[]=1234567891
    취소 요청 시 uuid[] 또는 identifier[]를 반드시 포함해야 합니다.
    두 파라미터 모두 선택(Optional) 파라미터이지만, 취소 대상 주문 지정을 위해 반드시 하나의 파라미터를 포함해야 합니다. 두 파라미터를 동시에 사용할 수 없습니다.
    반영 버전 반영 일자 변경 사항
    - 2024-12-11 '지정 주문 목록 취소' 기능 신규 지원
    Rate Limit
    초당 최대 30회 호출할 수 있습니다. 포켓 단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.

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

    Query Params
    uuids[]
    array of strings

    취소하고자 하는 주문의 UUID 목록.
    취소 가능한 최대 주문 개수는 20개입니다. 2개 이상의 UUID로 조회하는 경우 쿼리 파라미터를 다음과 같이 요청합니다.

    [예시] uuids[]=uuid1&uuids[]=uuid2…

    uuids[]
    identifiers[]
    array of strings

    취소하고자 하는 주문의 클라이언트 지정 식별자 목록.
    취소 가능한 최대 주문 개수는 20개입니다. 2개 이상의 identifiers로 조회하는 경우 쿼리 파라미터를 다음과 같이 요청합니다.

    [예시] identifiers[]=id1&identifiers[]=id2…

    identifiers[]
    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.