post
https://api.bithumb.com/v2/orders/batch
여러 건의 주문을 한 번의 요청으로 생성합니다. 요청당 최대 20건까지 가능합니다.
입력 규칙
- 지정가 주문: price와 volume 모두 필요
- 시장가 매수: price(총 금액) 필요
- 시장가 매도: volume 필요
client_order_id는 회원 단위로 고유해야 합니다. 동일 요청(batch_orders) 내에서 중복된 ID가 포함된 경우, 최초 항목만 정상 접수되며 이후 중복 건은 실패 처리됩니다.
안내 사항
서버가 요청을 정상적으로 수신 및 처리한 경우, 개별 주문 중 일부가 실패하더라도 상태 코드는 200 OK를 반환합니다.
현재 API 호출 제한은 IP별 초당 20회로 설정되어 있습니다. 다만, 시스템 상황이나 트래픽에 따라 이 제한은 변경될 수 있습니다.
기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, 개선 후에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소됩니다. 자세한 내용은 공지사항을 참고하세요.
응답 항목 "자전거래 방지 유형"
stp_type이 신규 추가되었으며, 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여stp_type필드가 필수 출력됩니다.
다건 주문에 포함된 각 주문에도 ioc, fok, post_only 처리 조건이 동일하게 적용됩니다. 자세한 동작과 시나리오별 최종 상태는 주문 요청 페이지를 참고하세요.
응답 항목 구분
batch_orders_response 배열 내 각 항목(Object)은 주문 처리 결과에 따라 성공 객체 또는 실패 객체 형태로 반환되며, 포함되는 필드가 다릅니다.
✅ 성공 객체에 포함되는 필드
- client_order_id(요청 시 전달한 경우에만)
- order_id
- market
- side
- order_type
- created_at
❌ 실패 객체에 포함되는 필드
- client_order_id(요청 시 전달한 경우에만)
- name
- message
성공/실패 구분 기준
order_id필드가 존재하면 성공order_id필드가 없고name,message가 존재하면 실패