이 API는 한 번의 요청으로 기존 주문을 취소한 후 동일 종목 및 동일 주문 사이드(매수/매도)로 새로운 주문을 생성하는 기능을 제공합니다.
Request Parameter
| Name | 설명 | 타입 |
|---|---|---|
| prev_order_uuid * | 취소할 주문의 UUID | String |
| prev_order_identifier * | 취소할 주문의 사용자 지정값
| String |
| new_ord_type * | 신규 주문의 주문 타입
| String |
| new_volume * | 신규 주문량 (지정가, 시장가 매도 시 필수)
| NumberString or remain_only |
| new_price * | 주문 가격. (지정가, 시장가 매수 시 필수) ex) KRW-BTC 마켓에서 1BTC당 1,000 KRW로 거래할 경우, 값은 1000 | NumberString |
| new_smp_type | 자전거래 체결 방지 (Self-Match Prevention) 타입 (선택) | String |
| new_identifier | 신규 주문의 조회용 사용자 지정값 (선택) | String (Uniq 값 사용) |
| new_time_in_force | 신규 주문의 IOC, FOK, Post Only 주문 설정 (선택)
ord_type이 best 혹은 limit 일때만 지원됩니다.post_only 의 경우, ord_type이 limit 일때만 지원됩니다. | String |
* 필수
* 특정 조건에서 필수
이 API 는 application/json 형식의 Content-Type 만 지원합니다. Query Parameter, Form Data 등 다른 형식의 요청은 지원하지 않으니 유의해주시기 바랍니다.
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, Post Only 설정 | String |
| identifier | 취소할 주문의 조회용 사용자 지정값 *identifier 필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다. | String |
| prevented_volume | 취소할 주문의 자전거래 체결 방지로 인해 취소된 주문 수량 | NumberString |
| prevented_locked | (매수 시) 자전거래 체결 방지 설정으로 인해 취소된 금액 (매도 시) 자전거래 체결 방지 설정으로 인해 취소된 수량 | NumberString |
| smp_type | 취소할 주문의 자전거래 체결 방지 (Self-Match Prevention) 타입 | String |
| new_order_uuid | 주문 성공 시 신규 주문의 UUID | String |
| new_order_identifier | 주문 성공 시 신규 주문의 조회용 사용자 지정값 | String |
신규 주문신규 주문은 취소할 주문과 같은 마켓에 접수되며, 기존 주문(
prev_order_uuid또는prev_order_identifier에 해당하는 주문)이 취소된 후 주문이 접수됩니다.신규 주문이 성공적으로 생성되었을 경우,
new_order_uuid또는 사용자가 요청 시 지정한new_identifier로 주문을 조회할 수 있습니다.취소 후 신규 주문이 성공적으로 요청되더라도, 기존 주문의 취소 처리가 완료되기 전에 전량체결된 경우 신규 주문은 생성되지 않습니다.