API 레퍼런스

가상자산 입출금 내역 단건 조회

출금 API를 통해 받은 ID를 이용하여 가상자산의 입출금 내역의 진행상태를 조회할 수 있습니다.

❗️

해당 API는 포트폴리오 기능을 지원하지 않습니다

포트폴리오 API Key 이용 시 지원하지 않는 API 목록

Request Header

필드필수설명
X-COINONE-PAYLOADtrueRequest body object -> JSON string -> base64
X-COINONE-SIGNATUREtrueHMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Request Body

fieldtyperequired/optionaldescription
access_tokenstringrequired사용자의 액세스 토큰 (access token)
noncestringrequiredUUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")
idstringrequired입출금 거래 식별 id

Response Body

KeyTypeDescription
resultString정상 반환 시 success, 에러 코드 반환 시 error
error_codeNumberStringerror 발생 시 에러코드 반환, 성공인 경우 0 반환
transactionsArray[Object]배열 형태의 가상자산 입출금 목록
- idString입출금 거래 식별 ID (예: "0fec72eb-1e4d-11e9-9ec7-00e04c3600d7")
- currencyString해당되는 종목의 심볼
- txidString블록체인상의 식별 ID (Transaction ID)
- typeString입출금 여부 (예: "WITHDRAWAL", "DEPOSIT")
- from_addressString발송 지갑 주소 (예: "muQoJGAySUJsn1c9iaj9GQitdVLJhnQVnL")
- from_secondary_addressString발송 지갑의 서브 주소 (XRP, XLM, EOS, 등의 메모, 태그)가 있을 경우 해당 주소 반환 (예: "153214622")
- to_addressString도착 지갑 주소 (예: "muQoJGAySUJsn1c9iaj9GQitdVLJhnQVnL")
- to_secondary_addressString도착 지갑의 서브 주소 (XRP, XLM, EOS, 등의 메모, 태그)가 있을 경우 해당 주소 반환 (예: "153214622")
- confirmationsNumber컨펌 수
- amountNumberString입금/출금 되는 수량
- feeNumberString거래 수수료
- statusString입출금 진행 상태 (아래 status 표 참고)
- created_atNumber입출금 거래 생성 시점 (unit of time: millisecond)

status

Transaction statusDescription
DEPOSIT_WAIT입금 대기 중, 입금 요청이 컨펌되지는 않고 블록체인에 등록만 된 상태
DEPOSIT_SUCCESS입금 완료, 블록체인에 반연 완료 된 상태
DEPOSIT_FAIL입금 실패
DEPOSIT_REFUND입금 건을 환급한 상태
DEPOSIT_REJECT불가능한 경로로 입금되어 입금 거부된 상태
WITHDRAWAL_REGISTER출금 등록, 출금 요청이 컨펌되지는 않고 블록체인에 등록만 된 상태
WITHDRAWAL_WAIT출금 대기 중, 출금 요청이 블록체인에 반영되고 컨펌이 진행 중인 상태
WITHDRAWAL_SUCCESS출금 완료
WITHDRAWAL_FAIL출금 실패
WITHDRAWAL_REFUND출금 실패한 건을 환급한 상태
WITHDRAWAL_REFUND_FAIL출금 환급이 실패한 상태
Language