post https://api.upbit.com/v1/orders
주문 요청을 한다.
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_force | IOC, FOK, Post Only 주문 설정 (선택) - ioc : 체결 가능한 수량만 즉시 체결, 나머지는 취소 (Immediate or Cancel)- fok : 전량 체결 가능할 때만 주문 실행, 아니면 전체 취소 (Fill or Kill)- post_only : 즉시 체결될 상황이면 주문 실행 없이 취소*ioc 및 fok 의 경우, ord_type 이 best 혹은 limit 일때만 지원됩니다.*post_only 의 경우, ord_type 이 limit 일때만 지원됩니다. | 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 필드가 신규로 추가되며, 가능한 타입은
ioc
와fok
입니다.
주문 설정 방법 지정가 (Limit) 최유리 지정가 (Best Order) 보통 - ord_type: limit
- side:bid
orask
- volume: 필수 입력
- price: 필수 입력X IOC - ord_type: limit
- side:bid
orask
- 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
orask
- 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_force | IOC, FOK, Post Only 설정 | String |
identifier | 조회용 사용자 지정값 *identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다. | String |
smp_type | 자전거래 체결 방지 (Self-Match Prevention) 타입 | String |
prevented_volume | 자전거래 체결 방지로 인해 취소된 주문 수량 | NumberString |
prevented_locked | (매수 시) 자전거래 체결 방지 설정으로 인해 취소된 금액 (매도 시) 자전거래 체결 방지 설정으로 인해 취소된 수량 | NumberString |