post
https://api.bithumb.com/v2/orders
주문을 요청합니다.
안내 사항기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, 개선 후에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소됩니다. 자세한 내용은 공지사항을 참고하세요.
응답 항목 "자전거래 방지 유형"
stp_type이 신규 추가되었으며, 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여stp_type필드가 필수 출력됩니다.
주문 처리 조건(time_in_force)
time_in_force)IOC / FOK / Post-Only / best 동작 상세
IOC (Immediate Or Cancel)
즉시 체결 가능한 수량만 체결하고, 미체결 잔량은 즉시 취소합니다.
- 체결 가능 수량 있음: 가능한 수량만 체결하고 잔량 즉시 취소. 부분 체결도
done(체결 완료)으로 처리됩니다. - 체결 가능 수량 없음: 주문 전체 즉시 취소.
- 어떤 경우에도 미체결 대기(
wait) 상태로 주문이 남지 않습니다.
FOK (Fill Or Kill)
주문 수량 전체를 즉시 체결할 수 있을 때만 체결하며, 그렇지 않으면 주문 전체를 즉시 취소합니다.
- 전량 즉시 체결 가능: 전체 수량 체결 처리.
- 전량 체결 불가(부분 체결 포함): 주문 전체 즉시 취소. 부분 체결 없음.
- 어떤 경우에도 미체결 대기(
wait) 상태로 주문이 남지 않습니다.
Post-Only
Maker 주문으로만 등록되며, Taker 체결 가격일 경우 주문이 취소됩니다.
- Taker 가격(즉시 체결되는 가격): 주문 즉시 취소(
state: cancel). - Maker 가격(호가창에 등록되는 가격): 미체결 대기(
state: wait)로 등록. 주문 취소 API로 취소 가능합니다. limit주문에서만 사용 가능합니다.best주문에서는 사용할 수 없습니다.
best + IOC / FOK
best 주문은 매수 시 매도 1호가, 매도 시 매수 1호가에 자동으로 주문 가격이 설정됩니다.
ioc: 해당 단일 호가에서 즉시 체결 가능한 수량만 체결하고 잔량 취소.fok: 해당 단일 호가에서 전량 즉시 체결이 가능할 때만 체결하며, 그렇지 않으면 전체 취소.
시나리오별 최종 상태
| 시나리오 | 최종 state |
|---|---|
ioc: 전량 체결 | done |
ioc: 일부 체결(잔량 즉시 취소) | done |
ioc: 체결 없음(전체 즉시 취소) | cancel |
fok: 전량 체결 | done |
fok: 전량 체결 불가(전체 즉시 취소) | cancel |
post_only: Taker 가격(즉시 취소) | cancel |
post_only: Maker 가격(호가창 등록) | wait |