API 레퍼런스

원화 입출금 내역 조회

원화의 전체 입출금 내역 조회

❗️

해당 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")
to_idstringoptional입력한 ID 이전의 내역 조회
is_depositbooleanoptionaltrue 입력 시 입금 내역만 조회, false 입력 시 출금 내역만 조회, null 입력 시 입금 출금 내역 모두 조회
sizeint32required한번에 조회할 목록 개수 (MAX: 100 MIN: 1)
from_tsint64required조회 시작 시점 입력 (UTC 기준 시간 입력, unit of time: millisecond)
to_tsint64required조회 종료 시점 입력 (UTC 기준 시간 입력, unit of time: millisecond)

Response Body

KeyTypeDescription
resultString정상 반환 시 success, 에러 코드 반환 시 error
error_codeNumberStringerror 발생 시 에러코드 반환, 성공인 경우 0 반환
transactionsArray[Object]배열 형태의 원화 입출금 목록
- idString입출금 거래 식별 ID (예: "0fec72eb-1e4d-11e9-9ec7-00e04c3600d7")
- statusString입출금 진행 상태 (아래 status 표 참고)
- amountNumberString거래 금액량
- feeNumberString거래 수수료
- typeString입출금 여부 (예: "WITHDRAWAL", "DEPOSIT")
- transaction_typeStringDEFAULT일 경우 은행 입출금 (예: "DEFAULT", "ETC")
- created_atNumber입출금 거래 생성 시점 (unit of time: millisecond)

status

Transaction statusDescription
DEPOSIT_COMPLETE입금 완료
DEPOSIT_WAIT입금 대기 중
DEPOSIT_PROCESSING입금 진행 중
DEPOSIT_FAILED입금 실패
WITHDRAWAL_COMPLETE출금 완료
WITHDRAWAL_WAIT출금 대기 중
WITHDRAWAL_PROCESSING출금 진행 중
WITHDRAWAL_FAILED출금 실패
REFUND_COMPLETE환급 완료

시간 범위 제약

시간 범위 필터의 최대 범위는 90일입니다. 초과 시 오류가 발생합니다.
'from_ts'가 'to_ts'보다 크면 오류가 발생합니다.
'from_ts' 또는 'to_ts'가 오늘 날짜보다 늦으면 오류가 발생합니다.

Language