post
https://api.bithumb.com/info/orders
회원의 매수/매도 등록 대기 또는 거래 중 내역 정보를 제공합니다.
안내 사항기존에는 자전거래 가능성이 있을 경우 주문이 접수되지 않았으나, 개선 후에는 주문 접수 후 체결 단계에서 자전거래를 감지해 충돌하는 신규 주문 수량만 취소됩니다. 자세한 내용은 공지사항을 참고하세요.
응답 항목 "자전거래 방지 유형"
stp_type이 신규 추가되었으며, 2026년 5월 7일 서비스 배포 이후 요청된 주문에 한하여stp_type필드가 필수 출력됩니다.
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 |
| type | 거래유형 (bid : 매수 ask : 매도) | String |
| count | 1~1000 (기본값 : 100) | Integer |
| after | 입력한 시간보다 나중의 데이터 추출 YYYY-MM-DD hh:mm:ss 의 UNIX Timestamp (2014-11-28 16:40:01 = 1417160401000) | Integer |
| order_currency | 주문 통화 (코인) | String/필수 |
| payment_currency | 결제 통화 (마켓) 입력값 : KRW, BTC, USDT | String |
Request Parameter에서 order_id 또는 type을 입력하면 order_id, type이 필수 값으로 적용
Response
| 필드 | 설명 | 타입 |
|---|---|---|
| status | 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) | String |
| order_currency | 주문 통화 (코인) | String |
| payment_currency | 결제 통화 (마켓) | String |
| order_id | 매수/매도 주문 등록된 주문번호 | String |
| order_date | 주문일시 타임 스탬프 | Integer |
| type | 주문 요청 구분 (bid : 매수 ask : 매도) | String |
| watch_price | 주문 접수가 진행되는 가격 (자동주문시) | String |
| units | 거래요청 Currency | String |
| units_remaining | 주문 체결 잔액 | Number (String) |
| price | 1 Currency당 주문 가격 | Number (String) |
| stp_type | 자전거래 방지 처리 유형 | String |