주문하기

주문 요청을 한다.

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 주문 설정*
- ioc : Immediate or Cancel
- fok : Fill or Kill
*ord_typebest 혹은 limit 일때만 지원됩니다.
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 제외

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 설정String
Language