주문하기

주문 요청을 한다.

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
Language