[업데이트] 주문 기능 고도화 및 WebSocket Private v2 출시 안내

안녕하세요. 당신의 안전한 금융 파트너, 빗썸입니다.

빗썸 Open API를 이용하시는 회원님께 다양한 주문 전략을 지원하기 위해 최유리 지정가 주문과 주문 처리 조건(IOC/FOK/post_only) 을 도입했으며, WebSocket Private v2 응답 스펙을 추가했습니다.

■ 주요 일정

신규 기능 적용: 2026년 6월 30일(화)
WebSocket Private v1 종료: 2026년 9월 30일(수)

■ 적용 대상

마켓: 원화(KRW)
버전: v1.2.0, v2.1.0, v2.1.5, WebSocket

■ 주요 변경 사항

이번 업데이트로 신규 추가된 기능입니다.

최유리 지정가 주문(best) 도입
주문 처리 조건(time_in_force) 도입: ioc, fok, post_only
취소 유형(cancel_type)에 tif_cancel 추가: 주문 조건에 의한 취소
WebSocket Private v2 응답 스펙 출시

■ 변경 내용 상세

신규 개념

1. 신규 주문 유형: best(최유리 지정가)

매수는 매도 1호가, 매도는 매수 1호가로 즉시 체결을 시도합니다. 1호가 잔량을 초과하는 수량은 체결되지 않으며, 슬리피지를 제한하면서 빠르게 체결하고자 할 때 사용합니다. time_in_force는 ioc 또는 fok로 지정해야 합니다.

2. 신규 파라미터: time_in_force(주문 처리 조건)

이번 업데이트로 처음 도입되는 신규 파라미터입니다. 주문의 체결 방식과 미체결 수량의 처리 방식을 결정하며, 지정가(limit)와 최유리 지정가(best) 주문에 적용할 수 있습니다. 가능한 값은 ioc(Immediate or Cancel), fok(Fill or Kill), post_only 입니다.

주문유형	주문조건	설명
지정가(`limit`)	보통(미지정)	지정한 가격으로 접수. 즉시 체결 가능하면 체결, 아니면 미체결 주문으로 대기(Maker / Taker)
지정가(`limit`)	`ioc`	즉시 체결 가능한 수량만 체결, 잔량 자동 취소(Taker 전용)
지정가(`limit`)	`fok`	전량 체결 가능 시에만 체결, 부족하면 전체 취소(Taker 전용)
지정가(`limit`)	`post_only`	Maker 주문으로만 호가창에 등록되며, Taker가 되는 가격이면 자동 취소(Maker 전용)
최유리 지정가(`best`)	`ioc`	상대 호가 기준 가격으로 자동 결정 후 즉시 체결 가능한 수량만 체결, 잔량 자동 취소(Taker 전용)
최유리 지정가(`best`)	`fok`	상대 호가 기준 가격으로 자동 결정 후 전량 체결 가능 시에만 체결, 부족하면 전체 취소(Taker 전용)

3. 신규 취소 유형: tif_cancel

cancel_type 응답 값에 새로 추가되는 취소 유형입니다. 주문 처리 조건(IOC/FOK/post_only)에 의해 취소된 경우 반환됩니다.

엔드포인트별 영향

1. POST /v2/orders(주문 요청) — v2.1.5

Request order_type에 best 추가
Request, Response time_in_force 추가

2. POST /v2/orders/batch(다건 주문 요청) — v2.1.5

Request order_type에 best 추가
Request, Response time_in_force 추가

3. GET /v1/orders(주문 리스트 조회) — v2.1.0, v2.1.5

Response ord_type에 best 추가
Response time_in_force 추가

4. GET /v1/order(개별 주문 조회) — v2.1.0, v2.1.5

Response ord_type에 best 추가
Response time_in_force 추가
Response cancel_type에 tif_cancel 추가

5. 거래 주문내역 상세 조회 — v1.2.0

Response cancel_type에 tif_cancel 추가

6. WebSocket MyOrder — v1, v2

응답 order_type(ot) 값에 best 추가
응답 cancel_type(ct) 값에 tif_cancel 추가
(v2 전용) 응답에 time_in_force(tif) 추가 — v1 미지원, 사용 시 v2 마이그레이션 필요

WebSocket Private v2 출시

myOrder 스트림 응답 스펙을 더 명확하고 일관되게 개선한 Private v2를 출시했습니다. 식별자 이름을 표준화하고 주문/체결 정보를 분리하여 응답 데이터의 활용도와 개발 편의성을 높였습니다.

주요 개선 사항

식별자 이 일관성 강화: uuid → order_id, trade_uuid → trade_id, canceling_uuid → canceling_order_id
직관적인 매수/매도 표현: ask_bid(ASK/BID) → side(buy/sell)
주문 정보와 체결 정보 분리: price → order_price/trade_price, volume → order_quantity/trade_quantity
신규 필드 추가로 정보 보강: time_in_force, order_amount, trade_amount

기존 v1은 그대로 사용하실 수 있으며, 2026년 9월 30일(수)까지 제공 후 종료될 예정이므로 그 전에 v2로 마이그레이션해 주시기 바랍니다.

자세한 변경 사항과 마이그레이션 방법은 아래 변경 적용 문서를 참고하세요.

■ 변경 적용 문서

이번 업데이트로 다음 문서가 업데이트되었습니다.

버전	문서
v1.2.0	거래 주문내역 상세 조회
v2.1.0	주문 리스트 조회, 개별 주문 조회
v2.1.5	주문 요청, 다건 주문 요청, 주문 리스트 조회, 개별 주문 조회
WebSocket	내 주문 및 체결(MyOrder) v2 / v1, Private v2 마이그레이션 가이드

■ 유의사항

신규 주문 유형과 처리 조건이 적용된 이후에도 기존 주문 방식은 그대로 사용할 수 있습니다.
WebSocket Private v1은 2026년 9월 30일(수) 종료됩니다.

앞으로도 빗썸은 회원님의 편리하고 안전한 거래를 위해 노력하겠습니다.

감사합니다.