OrdersPrivate API

회원의 매수/매도 등록 대기 또는 거래 중 내역 정보를 제공합니다.

POST https://api.bithumb.com/info/orders

Example Response

{
    "status"    : "0000",
    "data"      : [
        {
            "order_id"                   : "1412562509982",
            "order_currency"       : "BTC",
            "order_date"               : 1412562509982,
            "payment_currency"  : "KRW",
            "type"                           : "bid",
            "status"                        : "placed",
            "units"                          : "5.0",
            "units_remaining"      : null,
            "price"                          : "501000",
            "fee"                             : null,
            "total"                          : null,
            "date_completed"    : null
        }
    ]
}

Request Parameters

요청 변수, 설명, 타입으로 구성된 표
요청 변수 설명 타입
apiKey 사용자 API Key String/필수
secretKey 사용자 Secret Key String/필수
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
currency 암호화폐 영문 코드
기본값 : BTC
String

※ Request Parameter에서 order_id 또는 type을 입력하면 order_id, type이 필수 값으로 적용

Response

필드, 설명, 타입으로 구성된 표
필드 설명 타입
status 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) String
order_currency 주문 화폐 단위 (코인) String
order_date 주문일시 타임 스탬프 Integer
payment_currency 결제 화폐 단위 (KRW) String
type 주문 요청 구분 (bid : 매수 ask : 매도) String
status 주문상태 (placed : 거래 진행 중) String
units 거래요청 Currency String
units_remaining 주문 체결 잔액 Number (String)
price 1Currency당 거래금액 Number (String)
fee 거래 수수료 Number (String)
total 거래체결 완료 총 거래금액, 완료상태가 아닌 경우 NULL Number (String)
date_completed 거래체결 완료일시 타임 스탬프, 완료상태가 아닌 경우 NULL Integer