API 레퍼런스

가상자산 출금

2차 인증 및 수취인정보 입력이 완료된 주소에 대해 API를 이용한 출금을 요청합니다.

❗️

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

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

코인원 홈페이지 > Open API > 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")
currencystringrequired출금하려는 가상자산
amountstringrequired출금하려는 수량
addressstringrequired출금 주소 (가상자산을 입금 받게될 주소)
secondary_addressstringoptionalmemo 혹은 dtag값

Response Body

KeyTypeDescription
resultString정상 반환 시 success, 에러 코드 반환 시 error
error_codeNumberStringerror 발생 시 에러코드 반환, 성공인 경우 0 반환
transactionObject
- idString입출금 거래 식별 ID (예: "0fec72eb-1e4d-11e9-9ec7-00e04c3600d7")
- currencyString해당되는 종목의 심볼
- addressString도착 지갑 주소 (예: "muQoJGAySUJsn1c9iaj9GQitdVLJhnQVnL")
- secondary_addressString도착 지갑의 서브 주소 (XRP, XLM, EOS, 등의 메모, 태그)가 있을 경우 해당 주소 반환 (예: "153214622")
- amountNumberString입금/출금 되는 수량
- statusString입출금 진행 상태 (아래 status 표 참고)

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