주문하기

주문 요청을 한다.

Request Parameters

Name설명타입
market *마켓 ID (필수)String
side *주문 종류 (필수)
  • bid : 매수
  • ask : 매도
String
volume *주문량 (지정가, 시장가 매도 시 필수)NumberString
price *주문 가격. (지정가, 시장가 매수 시 필수)
ex) KRW-BTC 마켓에서 1BTC당 1,000 KRW로 거래할 경우, 값은 1000 이 된다.
ex) KRW-BTC 마켓에서 1BTC당 매도 1호가가 500 KRW 인 경우, 시장가 매수 시 값을 1000으로 세팅하면 2BTC가 매수된다.
(수수료가 존재하거나 매도 1호가의 수량에 따라 상이할 수 있음)
NumberString
ord_type *주문 타입 (필수)
  • limit : 지정가 주문
  • price : 시장가 주문(매수)
  • market : 시장가 주문(매도)
  • best : 최유리 주문 (time_in_force 설정 필수)
String
identifier조회용 사용자 지정값 (선택)String (Uniq 값 사용)
time_in_forceIOC, FOK, Post Only 주문 설정 (선택)
  • ioc : 체결 가능한 수량만 즉시 체결, 나머지는 취소 (Immediate or Cancel)
  • fok : 전량 체결 가능할 때만 주문 실행, 아니면 전체 취소 (Fill or Kill)
  • post_only : 즉시 체결될 상황이면 주문 실행 없이 취소
ioc 및 fok 의 경우, ord_typebest 혹은 limit 일때만 지원됩니다.
post_only 의 경우, ord_typelimit 일때만 지원됩니다.
String
smp_type자전거래 체결 방지 (Self-Match Prevention) 타입 (선택)
  • reduce : 동일 회원 주문과 매칭 시, 두 주문을 체결시키지 않고 양쪽 주문 수량을 줄여 체결 방지 (잔량 0이면 취소)
  • cancel_maker : 동일 회원 주문과 매칭 시, maker 주문을 취소
  • cancel_taker : 동일 회원 주문과 매칭 시, 현재 주문을 취소
*자전거래 체결 방지는 taker 주문의 smp_type 기준으로 동작합니다. 자세한 설명은 해당 가이드를 참고부탁드립니다.
String

* 필수
* 특정 조건에서 필수

🚧

원화 마켓 가격 단위를 확인하세요.

원화 마켓에서 주문을 요청 할 경우, 원화 마켓 주문 가격 단위 를 확인하여 값을 입력해주세요.

🚧

identifier 파라미터 사용

identifier는 서비스에서 발급하는 uuid가 아닌 사용자가 직접 발급하는 키값으로, 주문을 조회하기 위해 할당하는 값입니다. 해당 값은 사용자의 전체 주문 내 유일한 값을 전달해야하며, 비록 주문 요청시 오류가 발생하더라도 같은 값으로 다시 요청을 보낼 수 없습니다.

주문의 성공 / 실패 여부와 관계없이 중복해서 들어온 identifier 값에서는 중복 오류가 발생하니, 매 요청시 새로운 값을 생성해주세요.

🚧

시장가 주문

주문 설정 방법시장가
매수- ord_type: price
  • side: bid
  • volume: null or 제외
  • price: 필수 입력
매도- ord_type: market
  • side: ask
  • volume: 필수 입력
  • price: null or 제외
  • 시장가 주문은 ioc, fok 를 지원하지 않습니다.
📘

신규 주문 타입 및 조건 지원 (전체 마켓 지원 2024. 04. 22 ~)

  • 신규 주문 타입이 추가되었습니다: 최유리 지정가 (ord_type 필드에 best 타입 추가)

  • 신규 주문 조건이 추가 되었습니다: IOC (Immediate or Cancel), FOK (Fill or Kill)

    • time_in_force 필드가 신규로 추가되며, 가능한 타입은 iocfok입니다.
주문 설정 방법지정가 (Limit)최유리 지정가 (Best Order)
보통- ord_type: limit
  • side: bid or ask
  • volume: 필수 입력
    - price: 필수 입력
X
IOC- ord_type: limit
- side: bid or ask
  • volume: 필수 입력
    - price: 필수 입력
  • time_in_force: ioc
- ord_type: best
  • time_in_force: ioc[매수 시]
    - side: bid

  • volume: null or 제외

  • price: 필수 입력**[매도 시]**
    - side: ask

  • volume: 필수 입력

  • price: null or 제외

FOK- ord_type: limit
- side: bid or ask
  • volume: 필수 입력
    - price: 필수 입력
  • time_in_force: fok
- ord_type: best
  • time_in_force: fok[매수 시]
    - side: bid

  • volume: null or 제외

  • price: 필수 입력**[매도 시]**
    - side: ask

  • volume: 필수 입력

  • price: null or 제외

📘

Post Only 및 자전거래 체결 방지 기능 추가 (2025. 07. 02 ~)

  • post_only 주문 조건이 추가되었습니다.

    • time_in_force 필드에서 post_only 타입 설정 가능
    • 지정가 주문만 지원, SMP(Self-Match Prevention)는 미지원
  • 자전거래 체결 방지 (Self-Match Prevention) 기능이 추가되었습니다.

    • smp_type 필드가 신규로 추가되며, 가능한 타입은 reduce, cancel_maker, cancel_taker

Response

필드설명타입
uuid주문의 고유 아이디String
side주문 종류String
ord_type주문 방식String
price주문 당시 화폐 가격NumberString
state주문 상태String
market마켓의 유일키String
created_at주문 생성 시간String
volume사용자가 입력한 주문 양NumberString
remaining_volume체결 후 남은 주문 양NumberString
reserved_fee수수료로 예약된 비용NumberString
remaining_fee남은 수수료NumberString
paid_fee사용된 수수료NumberString
locked거래에 사용중인 비용NumberString
executed_volume체결된 양NumberString
trades_count해당 주문에 걸린 체결 수Integer
time_in_forceIOC, FOK, Post Only 설정String
identifier

조회용 사용자 지정값

*identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다.

String
smp_type자전거래 체결 방지 (Self-Match Prevention) 타입String
prevented_volume자전거래 체결 방지로 인해 취소된 주문 수량NumberString
prevented_locked(매수 시) 자전거래 체결 방지 설정으로 인해 취소된 금액
(매도 시) 자전거래 체결 방지 설정으로 인해 취소된 수량
NumberString
Body Params
string
required

Market ID

string
required

주문 종류

string
required

주문 수량

string
required

유닛당 주문 가격

string
required

주문 타입

string

조회용 사용자 지정 값

string

IOC, FOK 주문 설정

string

자전거래 체결 방지 타입

Headers
string
required

Authorization token (JWT)

Responses

Language
Request
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.