자전거래 체결 방지(Self-Match Prevention, SMP)

자전거래 체결 방지 기능이 무엇인가요?

자전거래 체결 방지(Self-Match Prevention, 이하 SMP)는 동일 회원의 서로 반대 방향 주문이 체결되는 자전거래를 방지하기 위한 기능입니다.

이를 통해 의도하지 않은 자전거래와 불필요한 수수료 발생을 방지하고, 관련 규제를 보다 효과적이고 안정적으로 준수할 수 있도록 지원합니다.

어떻게 설정하나요?

다음 API 엔드포인트의 SMP 파라미터를 통해 설정할 수 있습니다.

smp_type에는 어떤 값을 설정할 수 있나요?

SMP는 Taker 주문에 설정된 값을 기준으로 동작합니다.
따라서 호가창에 이미 남아 있는 Maker 주문에 설정된 SMP 값은 이후 체결 시 적용되지 않습니다.
smp_type에는 다음의 허용 값을 설정할 수 있습니다.

post_only 주문에서는 어떻게 동작하나요?

time_in_force=post_only 주문에서는 다음과 같이 처리됩니다.

• smp_type=none은 함께 사용할 수 있습니다.
• smp_type=reduce, cancel_maker, cancel_taker는 함께 사용할 수 없습니다.

SMP 설정으로 인해 주문이 취소되었는지 어떻게 확인하나요?

SMP로 인해 주문이 취소되거나 수량이 차감된 경우 주문 관련 응답의 다음 필드를 통해 확인할 수 있습니다.

WebSocket으로 내 주문 및 체결(MyOrder) 데이터를 구독하는 경우 state 필드를 통해 SMP 적용 결과를 확인할 수 있습니다.

• prevented: SMP로 인해 주문 수량 또는 금액이 차감된 경우
• cancel: SMP 적용 결과 주문 수량 또는 금액이 더 이상 남아 있지 않아 주문이 취소된 경우

유의사항

• 자전거래 여부는 주문 시점이 아닌 체결 시점에 확인합니다.
• 시장가, 지정가, 예약가, IOC/FOK, 취소 후 재주문 등 지원되는 모든 주문 타입(ord_type)과 함께 사용할 수 있습니다.
• prevented_locked는 다음과 같이 제공됩니다.
  • 매수 주문: SMP로 인해 체결이 방지된 주문 금액이며 수수료를 포함합니다.
    예를 들어 수수료가 0.25%인 경우 체결이 방지된 주문 금액에 1.0025를 곱한 값입니다.
  • 매도 주문: 수수료와 관계없이 SMP로 인해 체결이 방지된 주문 수량이며, prevented_volume과 동일합니다.
• 주문 관련 REST API 응답에서 smp_type, prevented_volume, prevented_locked 필드는 항상 제공됩니다.
  • smp_type은 주문에 적용된 값을 반환합니다.
  • 2026-11-09 이전에 생성된 주문에서 smp_type을 지정하지 않은 경우 none으로 반환됩니다.
• WebSocket으로 내 주문 및 체결(MyOrder) 데이터를 구독하는 경우에도 smp_type, prevented_volume, prevented_locked 필드가 응답에 포함됩니다.
• “smp_type" : "none"인 경우 prevented_volume 및 prevented_locked는 0으로 반환됩니다.