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 주문 설정* - ioc : Immediate or Cancel- fok : Fill or Kill* ord_type 이 best 혹은 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 필드가 신규로 추가되며, 가능한 타입은
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 제외
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 설정 | String |
identifier | 조회용 사용자 지정값 *identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다. | String |