Kraken · 자산별 원자료

크라켄 Ledgers 원자료를 API로 조회하고 보관해요.

크라켄 기본 지갑의 BTC 또는 USD 기록을 골라, 금액·수수료·잔액의 원값을 CSV·JSON으로 보관해요. 이 조회는 계산 원장을 바꾸지 않으며, 기존 매매 내역의 수수료도 교체하지 않아요.

공식 명세·공개 자산 정보와 합성 응답으로 검증한 시험 기능이에요. 실제 계정 기록과 대조하는 검증은 아직 마치지 않았어요.

공식 문서·기능 확인일: 2026년 9월 9일

어떤 자료가 필요한지 골라요.

현물 매수·매도 체결: 거래쌍별 체결을 가져오려면 크라켄 현물 API 가이드를 따라요.
금액·수수료·잔액 원값: 자산 하나의 기록을 따로 보관하려면, 이 가이드의 Ledgers 원자료 조회를 사용해요.

Ledgers는 한 행에 자산 하나의 변화를 담아요. BTC 기록의 amount·fee·balance는 BTC 단위이며, USD 기록은 USD 단위예요. 매수·매도 체결과 행 수가 같다고 놓고 합치거나, 기록의 수수료를 기존 체결 수수료에 더하지 않아요.

조회할 자산과 기간을 확인해요.

지갑: 목록에서 확인되는 활성 기본 지갑(main) 하나예요.
자산과 유형: BTC 또는 USD 하나의 trade 유형 기록만 받아요. 원자료에는 BTC가 XXBT, USD가 ZUSD로 표시돼요.
기간: 한국 시간으로 오늘을 제외한 최근 31일 중 최대 7일이에요. 시작일과 종료일을 포함하고, 종료일 다음 날 00:02부터 조회할 수 있어요.
건수: 날짜 경계 확인에 필요한 행까지 합쳐 최대 100행이에요. 이 한도를 넘으면 일부만 반환하지 않고 기간을 줄이도록 안내해요.

31일·7일·100행은 현재 Kontaxt의 조회 제한이에요. Kraken의 전체 자료 보관 기간을 뜻하지 않아요. 다른 지갑·자산과 입출금·보상, spend·receive처럼 trade가 아닌 유형은 이번 조회에 포함하지 않아요.

읽기 전용 키로 조회해요.

1
Kraken Pro에서 전용 키를 준비해요.
오른쪽 위 프로필 메뉴에서 Settings → API → Create API key를 열어요. Query Ledger Entries 권한을 켜고, 주문·출금 등 조회 외 권한은 끈 뒤 키를 만들어요. 키의 유효기간과 조회 가능 기간도 확인해 주세요.
2
자산과 조회할 날짜를 골라요.
구독 계정으로 로그인한 뒤 크라켄 자산 원자료 조회 화면에서 BTC 또는 USD 하나와 한국 시간의 시작일·종료일을 선택해요. 조회 과정에서 활성 main 지갑이 하나인지 확인해 선택해요.
3
키를 입력하고 조회 결과를 읽어요.
API 키와 시크릿 키를 입력한 뒤 ‘자산 원자료 조회’를 눌러요. 제출하면 입력란은 비워져요. 결과에서 선택 자산·기간·받은 건수와 날짜 경계에서 제외한 건수를 함께 확인해 주세요.
4
화면을 떠나기 전에 파일을 저장해요.
‘원자료 CSV 저장’ 또는 ‘원자료 JSON 저장’을 눌러요. 결과는 현재 화면에만 있으므로 새로고침하거나 화면을 벗어나면 사라져요. 이미 받은 자료는 같은 Kontaxt 계정·로그인 세션에서 구독이 끝나도 내려받을 수 있지만, 새 조회와 새 결과를 받는 시점에는 구독 상태를 확인해요.

다른 앱과 공유하지 않는 전용 읽기 키를 권장해요. API 키에 별도의 추가 인증(2FA)이 필요한 설정은 현재 지원하지 않으며, Kraken 로그인용 2단계 인증과는 구분해요. 다음 조회에는 키를 다시 입력해요.

원값과 누락 표시를 함께 보관해요.

기록을 펼치면 원래 time과 금액·수수료·잔액을 볼 수 있어요. 화면의 시각은 한국 시간의 초 단위이며, 소수 부분을 포함한 원래 time은 파일에 남겨요. 음수·0·소수점 아래 끝자리 0을 그대로 보관하고, 항목 누락·null·빈 문자열도 서로 구분해요. 수수료가 음수라고 환급으로 바꾸거나, 비어 있는 값을 0으로 채우지 않아요.

CSV에는 숫자 자동 변환과 수식 실행을 줄이기 위한 작은따옴표를 붙여요. 비어 있지 않은 원자료와 조회 기간 등의 메타데이터 값이 대상이며, protectedFields에 보호한 위치를 적어요. 원값을 복원할 때는 표시된 위치에서 추가한 작은따옴표 하나만 제거해요. JSON에는 이 보호 문자를 붙이지 않으므로, 원값과 누락 상태를 대조할 때 함께 보관해 주세요.

두 파일은 Kontaxt가 조회한 선택 항목의 보관본이에요. trade 기록만 받은 상태에서 계정 전체 잔액이나 기간 전체 수수료를 계산하지 않아요.

자주 묻는 질문이에요.

완료되면 자료가 모두 모인 건가요?

제공처의 조회 페이지를 순회하고 첫 페이지를 다시 대조했다는 뜻이에요. 색인 누락이나 계정 전체 이력의 완전성까지 확인한 것은 아니에요. 0건일 때도 선택한 지갑·자산·유형·기간부터 다시 살펴요.

조회가 중단되면 기존 자료도 사라지나요?

같은 로그인 세션에서 이전에 받은 결과는 유지해요. 100행 초과라면 기간을 줄이고, 권한·지갑 확인 실패라면 표시된 안내를 확인해 주세요. 요청 제한이나 nonce 오류 뒤에는 자동으로 재시도하지 않으니, 대기 안내와 다른 앱의 동일 키 사용 여부를 살펴요.

이 파일로 기존 매매 자료를 보완할 수 있나요?

원값을 따로 살펴보는 자료로 보관해요. 매매 체결에 자동 연결하거나 수수료를 교체하는 기능은 아직 없어요. Kraken이 내보낸 원본 CSV나 Kontaxt의 계산용 업로드 파일로 쓰지 않아요.

계산에 사용할 크라켄 파일을 준비한다면 Trades CSV 가이드를 확인해 주세요.

공식 출처를 확인해요.

구독 계정으로 로그인한 뒤, 읽기 전용 키와 조회할 자산·기간을 준비해 주세요.

크라켄 자산 원자료 조회

크라켄 Ledgers 원자료를 API로 조회하고 보관해요.

공식 명세·공개 자산 정보와 합성 응답으로 검증한 시험 기능이에요. 실제 계정 기록과 대조하는 검증은 아직 마치지 않았어요.

공식 문서·기능 확인일: 2026년 9월 9일

어떤 자료가 필요한지 골라요.

현물 매수·매도 체결

거래쌍별 체결을 가져오려면 크라켄 현물 API 가이드를 따라요.

금액·수수료·잔액 원값

자산 하나의 기록을 따로 보관하려면, 이 가이드의 Ledgers 원자료 조회를 사용해요.

조회할 자산과 기간을 확인해요.

지갑

목록에서 확인되는 활성 기본 지갑(main) 하나예요.

자산과 유형

BTC 또는 USD 하나의 trade 유형 기록만 받아요. 원자료에는 BTC가 XXBT, USD가 ZUSD로 표시돼요.

기간

한국 시간으로 오늘을 제외한 최근 31일 중 최대 7일이에요. 시작일과 종료일을 포함하고, 종료일 다음 날 00:02부터 조회할 수 있어요.

건수

날짜 경계 확인에 필요한 행까지 합쳐 최대 100행이에요. 이 한도를 넘으면 일부만 반환하지 않고 기간을 줄이도록 안내해요.

읽기 전용 키로 조회해요.

Kraken Pro에서 전용 키를 준비해요.

오른쪽 위 프로필 메뉴에서 Settings → API → Create API key를 열어요. Query Ledger Entries 권한을 켜고, 주문·출금 등 조회 외 권한은 끈 뒤 키를 만들어요. 키의 유효기간과 조회 가능 기간도 확인해 주세요.

자산과 조회할 날짜를 골라요.

구독 계정으로 로그인한 뒤 크라켄 자산 원자료 조회 화면에서 BTC 또는 USD 하나와 한국 시간의 시작일·종료일을 선택해요. 조회 과정에서 활성 main 지갑이 하나인지 확인해 선택해요.

키를 입력하고 조회 결과를 읽어요.

API 키와 시크릿 키를 입력한 뒤 ‘자산 원자료 조회’를 눌러요. 제출하면 입력란은 비워져요. 결과에서 선택 자산·기간·받은 건수와 날짜 경계에서 제외한 건수를 함께 확인해 주세요.

화면을 떠나기 전에 파일을 저장해요.

‘원자료 CSV 저장’ 또는 ‘원자료 JSON 저장’을 눌러요. 결과는 현재 화면에만 있으므로 새로고침하거나 화면을 벗어나면 사라져요. 이미 받은 자료는 같은 Kontaxt 계정·로그인 세션에서 구독이 끝나도 내려받을 수 있지만, 새 조회와 새 결과를 받는 시점에는 구독 상태를 확인해요.