Home이용 안내API 레퍼런스변경 내역
API 레퍼런스

특정 주문 정보 조회

주문 식별 ID에 해당되는 주문 정보 조회

📘

Permission: 주문조회 (History)

🚧

Private API V2.1 '주문 정보 조회' API를 사용하시기 바랍니다

V2.1 주문 정보 조회

Response Body

KeyTypeDescription
resultString정상 반환 시 success, 에러 코드 반환 시 error
error_codeNumberStringerror 발생 시 에러코드 반환, 성공인 경우 0 반환
orderObject주문 정보 오브젝트
- order_idString주문 식별 ID (예: "0e30219d-1e4d-11e9-9ec7-00e04c3600d7")
- typeString주문 방식 (Enum: "LIMIT", "MARKET")
- quote_currencyString마켓 기준 통화 (예: "KRW")
- target_currencyString주문 등록된 종목의 심볼 (예: "BTC")
- priceNumberString주문 금액
- original_qtyNumberString최초 주문 수량 (remain_qty + traded_qty + canceled_qty)
- executed_qtyNumberString부분 체결된 수량
- canceled_qtyNumberString취소된 수량
- remain_qtyNumberString취소되지 않고 남은 수량
- statusString주문 진행 상태 (아래 status 표 참고)
- sideString매수/매도 여부 (Enum: "BUY", "SELL")
- feeNumberString주문 수수료
- fee_rateNumberString주문 수수료율
- average_executed_priceNumberString체결된 주문의 평단가
- updated_atNumber주문 업데이트 시점 (unit of time: millisecond)
- created_atNumber주문 등록 시점 (unit of time: millisecond)

status

Order statusDescription
LIVE오더북에 등록된 상태로 취소나 체결이 되지 않은 상태
PARTIALLY_FILLED주문이 부분적으로 체결된 상태. 잔여 수량 존재함
PARTIALLY_CANCELED주문이 부분적으로 취소된 상태
FILLED주문이 모두 체결된 상태
CANCELED주문이 취소된 상태
Body Params
string
required

사용자의 액세스 토큰 (access token)

string
required

UUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")

string
required

조회하려는 주문 식별 ID

string
required
Defaults to KRW

조회하려는 주문의 마켓 기준 통화

string
required
Defaults to BTC

조회하려는 주문의 종목 심볼

Headers
string
required

Request body object -> JSON string -> base64

string
required

HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Response

Language
Request
Response
Choose an example:
application/json