특정 페어를 매수/매도하기 위한 주문을 생성합니다.
주문 유형(ord_type)
사용 가능한 주문 유형은 다음과 같습니다.
지정가 주문
지정가 주문은 사용자가 직접 설정한 매수/매도 단가, 또는 더 유리한 가격에 호가가 도달한 경우에만 체결되는 주문 유형입니다. 체결 단가의 상한/하한을 통제할 수 있지만, 시장 가격이 지정한 단가에 도달하지 않을 수 있으므로 체결을 보장할 수 없습니다.
table>
시장가 주문
시장가 주문은 현재 시장에서 가장 유리한 가격으로 즉시 체결되는 주문 유형입니다. 빠른 체결이 보장되지만, 시장 상황에 따라 체결 가격이 변동될 수 있습니다.
volume 파라미터를 입력하지 않습니다(value에 null로 입력 또는 key 자체를 제외). 각 파라미터에 대한 상세한 설명은 하단 Request Body를 참고해주세요.
table>
price 파라미터를 입력하지 않습니다(value에 null로 입력 또는 key 자체를 제외). 각 파라미터에 대한 상세한 설명은 하단 Request Body를 참고해주세요.
table>
최유리 지정가 주문
최유리 지정가 주문은 현재 시장에서 가장 유리한 상대 호가를 가격으로 하는 주문 유형입니다. 전량 체결을 항상 보장할 수는 없으나, 빠르게 유리한 가격으로 호가창에 진입하고 싶은 경우 유용합니다.
volume 파라미터를 입력하지 않습니다(value에 null로 입력 또는 key 자체를 제외). 각 파라미터에 대한 상세한 설명은 하단 Request Body를 참고해주세요.
table>
price 파라미터를 입력하지 않습니다(value에 null로 입력 또는 key 자체를 제외). 각 파라미터에 대한 상세한 설명은 하단 Request Body를 참고해주세요.
table>
주문 체결 조건(time_in_force)
주문 옵션으로, 주문 생성 시점의 체결 상황에 따른 주문 처리 방식을 지정할 수 있습니다.
<div className="accordion-content">
table>
</div>자전거래 체결 방지 옵션(SMP, Self-Matching Prevention)
smp_type 파라미터를 설정하여 자전거래 체결 방지 옵션을 원하는 모드로 활성화할 수 있습니다. 자전거래 체결 방지 기능과 관련된 자세한 사항은 자전거래 체결 방지(Self-Match Prevention, SMP) 페이지를 참고하시기 바랍니다.
table>
</div>체결 대기 중 자산 잠금
주문 생성시 해당 주문에 사용되는 호가 자산(매수 주문의 경우) 또는 기준 자산(매도 주문의 경우)이 즉시 잠금(locked) 상태로 전환되며, 다른 용도로 사용할 수 없게 됩니다. 이는 사용자의 잔고가 주문 체결 시점에도 유효하도록 보장하기 위한 동작이며 포켓 잔고 조회API 를 호출하여 잠금 자산 현황을 확인할 수 있습니다. 자산 잠금은 아래 조건 중 하나가 충족될 때까지 유지됩니다.
- 주문이 전량 체결되는 경우
- 사용자 요청으로 주문이 취소되는 경우
- time_in_force 조건에 따라 주문이 만료되는 경우
예시 ) KRW-BTC 마켓에서 지정가 매수 주문을 생성할 경우, 지정한 KRW 금액이 체결 전까지 잠금 상태로 유지됩니다.
주문 가격 단위와 최소 주문 가능 금액
마켓(호가 자산)과 기준 자산 단가에 따라 주문 시 사용 가능한 주문 가격 단위와 최소 주문 금액이 상이합니다. 마켓별 호가 정책은 아래 가이드를 참고하시기 바랍니다.
- 원화(KRW) 마켓 주문 가격 단위 / 최소 주문 가능 금액
- BTC 마켓 주문 가격 단위 / 최소 주문 가능 금액
- USDT 마켓 주문 가격 단위 / 최소 주문 가능 금액
클라이언트 주문 식별자(identifier)
주문 생성 시 업비트 시스템에서 주문을 고유하게 식별하기 위한 UUID와는 별도로, 사용자 클라이언트에서 각 주문을 식별하기 위해 직접 지정하는 값입니다. 사용자가 자체적인 주문 ID 체계를 통해 주문을 관리(조회 및 취소)하고자 할 때 활용됩니다.
identifier는 사용자 계정 내 전체 주문 기준으로 고유해야 하며, 이미 사용된 값은 해당 주문의 생성 또는 체결 여부와 관계없이 재사용할 수 없습니다. 또한 identifier의 최대 길이는 64자로 제한됩니다.
| 반영 버전 | 반영 일자 | 변경 사항 |
|---|---|---|
| v1.5.8 | 2025-07-07 | Post Only 주문 옵션 신규 지원 |
| v1.5.8 | 2025-07-02 | 자전거래 체결 방지(SMP) 기능 신규 지원에 따른 파라미터 추가 smp_type,prevented_volume,prevented_locked |
| 2024-12-04 | identifier 필드 신규 지원 | |
| 2024-04-22 | 최유리지정가 주문 유형 신규 지원 주문 옵션(time_in_force) 추가 지원 |
초당 최대 8회 호출할 수 있습니다. 포켓 단위로 측정되며 [주문 생성 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.