added

[안내] 자전거래 체결 방지 기능 출시 예정 (7/2)

#신규기능 #자전거래 체결 방지 #SMP

안녕하세요. 업비트 개발자센터입니다.
자전거래 체결 방지(Self-Match Prevention) 기능이 7월 2일 새롭게 추가될 예정입니다. 해당 기능은 의도치 않은 자기 주문 체결을 방지하여 불필요한 수수료 발생을 줄이고, 보다 효과적이고 안정적으로 관련 규제를 준수하는 데 도움이 되니 많은 관심 부탁드립니다.

*주문 조회(MyOrder 포함) 및 주문하기 기능 계열 전반의 응답 형식에 변경이 발생하므로, 2025년 7월 2일 이전까지 관련 로직을 반드시 점검해 주시기 바랍니다.


자전거래 체결 방지 기능이란

  • 동일 회원의 주문이 체결될 상황에 주문을 취소하여 자전거래를 방지 합니다. 다음의 3가지 타입으로 설정하실 수 있습니다.
    • cancel_taker: maker 주문을 유지하고, taker 주문을 취소하여 자전거래를 방지합니다.
    • cancel_maker: taker 주문을 유지하고, maker 주문을 취소하여 자전거래를 방지합니다.
    • reduce: 자기주문 수량만큼 maker, taker 양쪽 주문 수량을 줄여 자전거래를 방지합니다.
  • 유의사항
    • 선택(Optional) 기능으로, 별도로 설정하지 않으면 동작하지 않습니다.
    • taker 주문의 설정 기준으로 동작합니다. 보다 자세한 설명은 해당 가이드를 참고부탁드립니다.

자전거래 체결 방지 타입 설정하기

주문하기(POST v1/orders) 와 취소 후 재주문(POST /orders/cancel_and_new) 요청 시 smp_type 혹은 new_smp_type 파라미터로 자전거래 방지 모드를 설정할 수 있습니다.

파라미터설명타입
smp_type
or new_smp_type
자전거래 체결 방지 타입 (선택)

- reduce
- cancel_maker
- cancel_taker
String

자전거래 체결 방지 관련 정보가 주문 관련 응답에 공통적으로 추가 됩니다

  • 추가되는 필드
필드설명타입
smp_type적용된 자전거래 체결 방지 타입String
prevented_volume자전거래 체결 방지로 인해 취소된 주문 수량NumberString
prevented_locked(매수 시) 자전거래 체결 방지 설정으로 인해 취소된 금액
(매도 시) 자전거래 체결 방지 설정으로 인해 취소된 수량
NumberString
  • 아래 기능들의 응답 필드에 공통적으로 추가됩니다.

일정

  • 배포일 : 2025년 7월 2일 (수) 예정
  • 적용 API 문서 버전: v.1.5.8 이상

문의 사항이 있으실 경우, [email protected]으로 연락해 주시기 바랍니다.
최대한 신속하게 답변드리도록 하겠습니다.

감사합니다.
업비트 개발자센터 드림