post
https://api.coinone.co.kr/v2.1/transaction/krw/history
원화의 전체 입출금 내역 조회
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
요청 제한: 주문 외 Private API 전체 합산 초당 80회 · 포트폴리오 기준 · 자세히 보기
해당 API는 포트폴리오 기능을 지원하지 않습니다
Request Header
| 헤더 | 필수 | 설명 |
|---|---|---|
| X-COINONE-PAYLOAD | 필수 | Request body object -> JSON string -> base64 |
| X-COINONE-SIGNATURE | 필수 | HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest() |
Request Body
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| access_token | String | 필수 | 사용자의 액세스 토큰 (access token) |
| nonce | String | 필수 | UUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83") |
| to_id | String | 선택 | 입력한 ID 이전의 내역 조회 |
| is_deposit | Boolean | 선택 | true 입력 시 입금 내역만 조회, false 입력 시 출금 내역만 조회, null 입력 시 입금 출금 내역 모두 조회 |
| size | Number | 선택 | 한번에 조회할 목록 개수 (MAX: 100 MIN: 1) 기본값: 100 |
| from_ts | Number | 선택 | 조회 시작 시점 입력 (UTC 기준 시간 입력, unit of time: millisecond) 미입력 시 현재 시점 90일 전 |
| to_ts | Number | 선택 | 조회 종료 시점 입력 (UTC 기준 시간 입력, unit of time: millisecond) 미입력 시 현재 시점 |
Response Body
| 필드 | 타입 | 설명 |
|---|---|---|
| result | String | 정상 반환 시 success, 에러 코드 반환 시 error |
| error_code | NumberString | error 발생 시 에러코드 반환, 성공인 경우 0 반환 |
| transactions | Array[Object] | 배열 형태의 원화 입출금 목록 |
| transactions[].id | String | 입출금 거래 식별 ID (예: "0fec72eb-1e4d-11e9-9ec7-00e04c3600d7") |
| transactions[].status | String | 입출금 진행 상태 (아래 status 표 참고) |
| transactions[].amount | NumberString | 거래 금액량 |
| transactions[].fee | NumberString | 거래 수수료 |
| transactions[].type | String | 입출금 여부 (예: "WITHDRAWAL", "DEPOSIT") |
| transactions[].transaction_type | String | DEFAULT일 경우 은행 입출금 (예: "DEFAULT", "ETC") |
| transactions[].created_at | Number | 입출금 거래 생성 시점 (unit of time: millisecond) |
status
| 입출금 상태 | 설명 |
|---|---|
| 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'가 오늘 날짜보다 늦으면 오류가 발생합니다.