post
https://api.bithumb.com/info/order_detail
회원의 매수/매도 체결 내역 상세 정보를 제공합니다.
안내 사항기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, 개선 후에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소됩니다. 자세한 내용은 공지사항을 참고하세요.
응답 항목 "자전거래 방지 유형"
stp_type와 "취소 주문 고유 ID"canceling_order_id가 신규 추가되었습니다. 자전거래 취소인 경우cancel_type필드에는 "자전거래취소" 값이 반환됩니다. 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여stp_type필드가 필수 출력됩니다.
취소 주문에 대한 취소 결과 확인하기
- Order status 가 Cancel 상태임을 확인합니다.
- 아래 계산을 통해 취소 완료 수량(Cancel_qty)를 계산할 수 있습니다.
Cancel_qty = Order_qty - (contract 내에 각 units 총합)
Request Headers
| 요청 변수 | 설명 | 타입 |
|---|---|---|
| api-client-type | Api-Sign 생성 시 구분자 유형 "0" : Ascii Code 0 (기본값) "1" : Ascii Code 1 "2" : ";" (semicolon) | String/선택 |
| Api-Key | 사용자 API Key | String/필수 |
| Api-Nonce | 현재의 시간을 밀리초(millisecond, ms)로 표현한 값 (예 : "1655280216476") | String/필수 |
| Api-Sign | End Point + Request Parameter + Api-Nonce + 사용자 Secret Key를 조합하여 인코딩한 값 [상세 가이드 링크] | String/필수 |
Request Parameters
| 요청 변수 | 설명 | 타입 |
|---|---|---|
| order_id | 매수/매도 주문 등록된 주문번호 (입력 시 해당 데이터만 추출) | String/필수 |
| order_currency | 주문 통화 (코인) | String/필수 |
| payment_currency | 결제 통화 (마켓) 입력값 : KRW, BTC, USDT | String |
Response
| 필드 | 설명 | 타입 |
|---|---|---|
| status | 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) | String |
| order_date | 주문요청 시간 타임 스탬프 | Integer(String) |
| type | 주문 요청 구분 (bid : 매수 ask : 매도) | String |
| order_status | 주문 상태 | String |
| order_currency | 주문 통화 (코인) | String |
| payment_currency | 결제 통화 (마켓) | String |
| watch_price | 주문 접수가 진행된 가격 (자동주문시) | String |
| order_price | 주문요청 호가 | Number(String) |
| order_qty | 주문요청 수량 | Number(String) |
| cancel_date | 취소 일자 타임스탬프 | Integer(String) |
| cancel_type | 취소 유형 | String |
| contract | 해당주문 체결정보 | Array[Object] |
| contract.transaction_date | 거래 체결 시간 타임 스탬프 (YYYY-MM-DD HH:MM:SS) | Integer(String) |
| contract.price | 1 Currency당 체결가 | Number (String) |
| contract.units | 거래수량 | Number (String) |
| contract.fee_currency | 수수료 통화 | String |
| contract.fee | 거래 수수료 | Number (String) |
| contract.total | 체결 금액 | Number (String) |
| stp_type | 자전거래 방지 처리 유형 | String |
| canceling_order_id | 자전거래 취소인 경우, 해당 주문을 취소시킨 주문의 고유 ID | String |