주문 생성

주문 유형(ord_type)

사용 가능한 주문 유형은 다음과 같습니다.

지정가 주문

지정가 주문은 사용자가 직접 설정한 매수/매도 단가, 또는 더 유리한 가격에 호가가 도달한 경우에만 체결되는 주문 유형입니다. 체결 단가의 상한/하한을 통제할 수 있지만, 시장 가격이 지정한 단가에 도달하지 않을 수 있으므로 체결을 보장할 수 없습니다.

시장가 주문

시장가 주문은 현재 시장에서 가장 유리한 가격으로 즉시 체결되는 주문 유형입니다. 빠른 체결이 보장되지만, 시장 상황에 따라 체결 가격이 변동될 수 있습니다.

최유리 지정가 주문

최유리 지정가 주문은 현재 시장에서 가장 유리한 상대 호가를 가격으로 하는 주문 유형입니다. 전량 체결을 항상 보장할 수는 없으나, 빠르게 유리한 가격으로 호가창에 진입하고 싶은 경우 유용합니다.

주문 체결 조건(time_in_force)

주문 옵션으로, 주문 생성 시점의 체결 상황에 따른 주문 처리 방식을 지정할 수 있습니다.

자전거래 체결 방지 옵션(SMP, Self-Matching Prevention)

smp_type 파라미터를 설정하여 자전거래 체결 방지 옵션을 원하는 모드로 활성화할 수 있습니다. 자전거래 체결 방지 기능과 관련된 자세한 사항은 자전거래 체결 방지(Self-Match Prevention, SMP) 페이지를 참고하시기 바랍니다.

체결 대기 중 자산 잠금

주문 생성시 해당 주문에 사용되는 호가 자산(매수 주문의 경우) 또는 기준 자산(매도 주문의 경우)이 즉시 잠금(locked) 상태로 전환되며, 다른 용도로 사용할 수 없게 됩니다. 이는 사용자의 잔고가 주문 체결 시점에도 유효하도록 보장하기 위한 동작이며 계정 잔고 조회API 를 호출하여 잠금 자산 현황을 확인할 수 있습니다. 자산 잠금은 아래 조건 중 하나가 충족될 때까지 유지됩니다.

• 주문이 전량 체결되는 경우
• 사용자 요청으로 주문이 취소되는 경우
• time_in_force 조건에 따라 주문이 만료되는 경우

예시 KRW-BTC 마켓에서 지정가 매수 주문을 생성할 경우, 지정한 KRW 금액이 체결 전까지 잠금 상태로 유지됩니다.

주문 가격 단위와 최소 주문 가능 금액

마켓(호가 자산)과 기준 자산 단가에 따라 주문 시 사용 가능한 주문 가격 단위와 최소 주문 금액이 상이합니다. 마켓별 호가 정책은 아래 가이드를 참고하시기 바랍니다.

• 원화(KRW) 마켓 주문 가격 단위 / 최소 주문 가능 금액
• BTC 마켓 주문 가격 단위 / 최소 주문 가능 금액
• USDT 마켓 주문 가격 단위 / 최소 주문 가능 금액

클라이언트 주문 식별자(identifier)

주문 생성시 업비트 시스템 내에서 해당 주문을 유일하게 식별하기 위해 구분하는 UUID와 별개로, 주문을 생성하는 사용자 클라이언트 측에서 해당 주문을 식별하기 위해 할당하는 유일 구분자입니다. 사용자가 정의한 고유한 주문 ID 체계로 주문을 관리(조회 및 취소)하고자 하는 경우 유용합니다. 각 주문에는 사용자 계정의 전체 주문 내에서 유일하게 식별되는 값을 할당해야 하며, 한번 사용한 identifier 값은 해당 주문의 생성, 체결 여부와 상관 없이 재사용할 수 없습니다.