--- agentTools: projectIndex: https://apidocs.bithumb.com/llms.txt --- # [업데이트] 주문 기능 고도화 및 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 ### ■ 주요 변경 사항 이번 업데이트로 신규 추가된 기능입니다. 1. **최유리 지정가 주문(`best`)** 도입 2. **주문 처리 조건(`time_in_force`)** 도입: `ioc`, `fok`, `post_only` 3. **취소 유형(`cancel_type`)에 `tif_cancel` 추가**: 주문 조건에 의한 취소 4. **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 | [거래 주문내역 상세 조회](https://apidocs.bithumb.com/v1.2.0/reference/%EA%B1%B0%EB%9E%98-%EC%A3%BC%EB%AC%B8%EB%82%B4%EC%97%AD-%EC%83%81%EC%84%B8-%EC%A1%B0%ED%9A%8C) | | v2.1.0 | [주문 리스트 조회](https://apidocs.bithumb.com/v2.1.0/reference/%EC%A3%BC%EB%AC%B8-%EB%A6%AC%EC%8A%A4%ED%8A%B8-%EC%A1%B0%ED%9A%8C), [개별 주문 조회](https://apidocs.bithumb.com/v2.1.0/reference/%EA%B0%9C%EB%B3%84-%EC%A3%BC%EB%AC%B8-%EC%A1%B0%ED%9A%8C) | | v2.1.5 | [주문 요청](https://apidocs.bithumb.com/reference/%EC%A3%BC%EB%AC%B8-%EC%9A%94%EC%B2%AD), [다건 주문 요청](https://apidocs.bithumb.com/reference/%EB%8B%A4%EA%B1%B4-%EC%A3%BC%EB%AC%B8-%EC%9A%94%EC%B2%AD), [주문 리스트 조회](https://apidocs.bithumb.com/reference/%EC%A3%BC%EB%AC%B8-%EB%A6%AC%EC%8A%A4%ED%8A%B8-%EC%A1%B0%ED%9A%8C), [개별 주문 조회](https://apidocs.bithumb.com/reference/%EA%B0%9C%EB%B3%84-%EC%A3%BC%EB%AC%B8-%EC%A1%B0%ED%9A%8C) | | WebSocket | [내 주문 및 체결(MyOrder) v2](https://apidocs.bithumb.com/reference/%EB%82%B4-%EC%A3%BC%EB%AC%B8-%EB%B0%8F-%EC%B2%B4%EA%B2%B0-myorder) / [v1](https://apidocs.bithumb.com/reference/%EB%82%B4-%EC%A3%BC%EB%AC%B8-%EB%B0%8F-%EC%B2%B4%EA%B2%B0myorder-v1), [Private v2 마이그레이션 가이드](https://apidocs.bithumb.com/reference/private-v2-%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98-%EA%B0%80%EC%9D%B4%EB%93%9C) | ### ■ 유의사항 * 신규 주문 유형과 처리 조건이 적용된 이후에도 기존 주문 방식은 그대로 사용할 수 있습니다. * WebSocket Private v1은 **2026년 9월 30일(수)** 종료됩니다. 앞으로도 빗썸은 회원님의 편리하고 안전한 거래를 위해 노력하겠습니다. 감사합니다.