이 API는 한 번의 요청으로 기존 주문을 취소한 후 동일 종목 및 동일 주문 사이드(매수/매도)로 새로운 주문을 생성하는 기능을 제공합니다.
Request Parameter
| Name | 설명 | 타입 |
|---|---|---|
| prev_order_uuid | 취소할 주문의 UUID | String |
| prev_order_identifier | 취소할 주문의 사용자 지정값 | String |
| new_ord_type * | 신규 주문의 주문 타입 - limit : 지정가 주문- price : 시장가 주문(매수)- market : 시장가 주문(매도)- best : 최유리 주문 (time_in_force 설정 필수) | String |
| new_volume * | 신규 주문량 (지정가, 시장가 매도 시 필수) - 신규 주문 시 이전 주문의 잔여 수량을 사용하려면 remain_only 값을 입력해 주시기를 바랍니다. - remain_only 는 지정가 주문, 지정가 IOC/FOK 주문, 시장가 매도, 최유리 매도 주문만 지원합니다. | NumberString or remain_only |
| new_price * | 주문 가격. (지정가, 시장가 매수 시 필수) ex) KRW-BTC 마켓에서 1BTC당 1,000 KRW로 거래할 경우, 값은 1000 ex) KRW-BTC 마켓에서 1BTC당 매도 1호가가 500 KRW 인 경우, 시장가 매수 시 값을 1000으로 세팅하면 2BTC가 매수 됩니다. (단, 수수료와 매도 1호가의 수량에 따라 매수되는 수량은 상이할 수 있습니다) | NumberString |
| new_identifier | 신규 주문의 조회용 사용자 지정값 (선택) | String (Uniq 값 사용) |
| new_time_in_force | 신규 주문의 IOC, FOK 주문 설정* - ioc : Immediate or Cancel- fok : Fill or Kill* new_ord_type이 best 혹은 limit 일때만 지원됩니다. | String |
* 필수
* 특정 조건에서 필수
이 API 는 application/json 형식의 Content-Type 만 지원합니다. Query Parameter, Form Data 등 다른 형식의 요청은 지원하지 않으니 유의해주시기 바랍니다.
prev_order_uuid혹은prev_order_identifier둘 중 하나의 값이 반드시 포함되어야 합니다.
new_identifier는 prev_order_identifier와 달라야 합니다
identifier는 서비스에서 발급하는 uuid가 아닌 이용자가 직접 발급하는 키값으로, 주문을 조회하기 위해 할당하는 값입니다. 해당 값은 사용자의 전체 주문 내 유일한 값을 전달해야하므로 취소 후 재주문시에도 새로운 값이 필요합니다.
또한 주문 요청시 오류가 발생하더라도 같은 값으로 다시 요청을 보낼 수 없으니 매 요청시 새로운 값을 생성해주세요.
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 |
| new_order_uuid | 주문 성공 시 신규 주문의 UUID | String |
| new_order_identifier | 주문 성공 시 신규 주문의 조회용 사용자 지정값 | String |
신규 주문
신규 주문은 취소할 주문과 같은 마켓에 접수되며, 기존 주문(
prev_order_uuid또는prev_order_identifier에 해당하는 주문)이 취소된 후 주문이 접수됩니다.신규 주문이 성공적으로 생성되었을 경우,
new_order_uuid또는 사용자가 요청 시 지정한new_identifier로 주문을 조회할 수 있습니다.취소 후 신규 주문이 성공적으로 요청되더라도, 기존 주문의 취소 처리가 완료되기 전에 전량체결된 경우 신규 주문은 생성되지 않습니다.