세금 신고를 위해 API를 사용하는 방법

최종 업데이트: 2025년 3월 31일

Application Programming Interface(API)는 서로 다른 서비스(이 경우 거래소 및 세금 서비스)가 상호 작용하는 방식입니다.

때로는 서비스가 API를 통해 공개적으로 사용 가능한 데이터를 사용하여 자유롭게 통신할 수 있지만, 세금에 필요한 정보(예: 계정 잔액, 거래 내역 등)를 쿼리하는 경우 이 정보는 사용자 이름/비밀번호/2FA로 보호되므로(이 정보는 절대 누구와도 공유해서는 안 됩니다) 상황이 더 복잡해집니다.

API를 사용하여 세금 플랫폼을 Kraken 계정에 연결하는 것은 로그인 정보를 공유하지 않고도 계정의 데이터에 액세스할 수 있는 효율적인 방법입니다.

세금 플랫폼을 Kraken 계정에 연결하려면 API 키를 통해 세금 플랫폼에 계정 정보에 대한 액세스 권한을 부여해야 합니다.

어떤 제3자도 귀하의 사용자 이름/비밀번호/2FA를 알기를 원하지 않으며, 귀하의 계정에서 거래하거나 출금하는 것을 원하지 않으므로, 대신 적절한 권한을 가진 API 키가 사용됩니다.

API 키에 부여하는 권한은 다른 플랫폼이 귀하의 계정에서 무엇을 보고 무엇을 할 수 있는지에 대한 경계를 설정합니다.

일반적으로 세금 소프트웨어가 자본 이득/손실을 계산하는 데 필요한 권한은 다음과 같습니다.

자금 조회, 체결된 주문 및 거래 조회(일부 거래소의 경우 선택 사항), 원장 항목 조회, 데이터 내보내기.

이러한 권한은 읽기 전용 권한으로 알려져 있으며, 이는 다른 플랫폼이 귀하의 계정에 있는 자금과 계정 내역의 거래를 볼 수 있도록 허용하지만, 귀하의 계정에 어떠한 변경도 할 수 없음을 의미합니다(새로운 거래 및 새로운 자금 조달 거래 없음).

Kraken PRO에서 이것이 어떻게 보이는지 살펴보겠습니다.

Kraken PRO

Kraken에서 API를 생성하는 방법을 알아보려면 아래를 참조하십시오.

자금:

조회: API 키가 계정 잔액 및 자금 조달 기록(과거 입금 및 출금)을 볼 수 있도록 허용합니다.

주문 및 거래:

체결된 주문 및 거래 조회: API 키가 계정의 체결된 주문 및 거래를 볼 수 있도록 허용합니다(이는 손익을 결정하는 데 사용됩니다).

데이터:

원장 항목 조회: API 키가 모든 과거 거래/자금 조달 거래 기록인 계정 원장을 볼 수 있도록 허용합니다.

데이터 내보내기: API 키가 거래 및 계정 원장 내역을 포함하여 위에 언급된 모든 데이터를 내보낼 수 있도록 허용합니다(일반적으로 CSV 형식).

Kraken 계정을 Koinly에 연결하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

거주 국가를 선택하여 시작하십시오.

1

다음으로 지갑 추가를 클릭하고 Kraken을 선택하십시오.

2

API '자동 동기화' 방법을 사용하려면 Kraken.com에서 얻은 Public Key와 Private Key를 입력하고 Kraken 추가를 클릭하십시오.

3

3

4

CSV 파일을 수동으로 업로드하려면 CoinTracker CSV 가이드를 사용하여 데이터를 다시 포맷하고 CoinTracker CSV 템플릿에 로드하십시오.

이 작업이 완료되면 완성된 CoinTracker CSV 템플릿을 지정된 업로드 영역으로 끌어다 놓으십시오.

5

추가 지원이 필요한 경우 아래 CoinTracker 단계별 가이드를 참조하십시오.

메인 페이지에서 기본 설정을 지정하십시오.

1

다음 단계를 클릭한 다음 '더 많은 옵션 보기'를 클릭하십시오.

2

지갑/거래소 목록에서 Kraken을 선택하십시오.

4

5

Kraken Public Key와 Private Key를 API Key 및 Secret Key 필드에 복사하여 붙여넣고 "거래소 연결"을 클릭하십시오.

4

메인 페이지에서 '코인 입력'을 선택하고 Kraken을 검색하여 선택하십시오(Kraken Futures와 혼동하지 마십시오).

Select Exchange/Wallet

'새로운 자동 Kraken 작업 생성'으로 스크롤하여 API Key와 API Private Key(secret)를 붙여넣은 다음 '이 Kraken 작업 저장'을 클릭하십시오.

Input Public/Private Keys

CSV 파일을 수동으로 업로드하려면 'CSV 가져오기 탭'을 클릭한 다음 CSV 파일을 끌어다 놓고 '가져오기 계속'을 클릭하십시오.

Manually Upload CSV file

마지막으로 '가져오기 시작'을 클릭하십시오.

Manually upload CSV file

Successfully uploaded CSV file

추가 지원이 필요한 경우 아래 CoinTracking 단계별 가이드를 참조하십시오.

Kraken 데이터를 Crypto Tax Calculator(CTC)에 업로드하는 방법에 대한 포괄적인 가이드는 지원 문서인 을 참조하십시오.

대시보드 페이지에서 오른쪽 상단의 + 통합 버튼을 선택하십시오.

Blockpit

다음으로, 지갑을 선택하라는 메시지가 표시되면 Kraken을 선택하십시오.

가장 인기 있는 통합 목록에 명확하게 표시되어 있습니다.

다음으로 Kraken(Spot API Data용) 또는 Kraken Futures(Futures Data용)를 선택하십시오.

*Kraken Futures API Keys는 Kraken SPOT API Keys와 별개이며 상호 교환하여 사용할 수 없다는 점에 유의하십시오*

Blockpit

Blockpit 3

Kraken 계정에서 API Key와 API Private Key를 복사하여 Blockpit 웹사이트의 해당 필드에 붙여넣고 계속을 클릭하십시오.

Blockpit 3

'계속'을 클릭하면 계정 잔액 및 거래 내역 동기화 프로세스가 시작됩니다. 이는 계정 내역 길이에 따라 몇 초 또는 몇 분이 걸릴 수 있습니다.

Blockpit 4

Kraken(및 Kraken Futures) 잔액은 대시보드의 통합 아래에 표시되며, 여기에서 언제든지 데이터를 동기화하거나 활성 Blockpit 라이선스를 통해 24시간마다 자동으로 동기화할 수 있습니다.

추가 지원이 필요한 경우 아래 Blockpit 단계별 가이드를 참조하십시오.

  • 타사 소프트웨어에 공개 키와 비공개 키를 추가할 때 유효하지 않은 키 오류가 발생합니다.

    이 오류가 발생하면 먼저 비공개 키와 공개 키를 올바르게 복사했는지 확인하십시오. 이 작업을 수행했는데도 유효하지 않은 키 오류가 계속 발생하면 올바른 권한으로 새 키를 생성하고 다시 추가해 보십시오.

  • 제 Earn/스테이킹 잔액이 표시되지 않습니다.

    일부 타사 세금 소프트웨어는 API를 통해 스테이킹된 자산 잔액을 올바르게 가져오지 못합니다. 이 문제는 일반적으로 계정 내역을 내보내고 타사 사이트에 수동으로 업로드하여 해결할 수 있습니다. 계정 내역을 수동으로 내보내는 방법을 알아보려면 아래를 클릭하십시오.

  • 일부 거래 내역이 누락되었습니다.

    즉시 매수/매도 기능은 계정 거래 내역에 기록되지 않지만, 계정 원장(Ledger)에서 확인할 수 있습니다. 일부 타사 플랫폼은 계정 원장(Ledger)의 매수/매도 항목을 올바르게 해석하지 못합니다. 이 경우, 계정 내역을 수동으로 내보내고 해당 파일을 사용 중인 타사 플랫폼에 업로드하십시오.

  • 계정 내역을 수동으로 다운로드했지만, 기호가 무엇을 의미하는지 모르겠습니다.

    귀하의 전체 계정 내역은 원장(Ledger)과 거래(Trades)의 두 부분으로 구성됩니다. 먼저 이 둘의 차이점에 대해 알아보겠습니다.

    이제 계정 원장(Ledger)과 거래 내역(Trades history)의 차이점을 잘 이해했으니, 각각을 해석하는 방법을 살펴보겠습니다.

  • 타사 소프트웨어에 API 키를 제공해도 안전한가요?

    타사 사이트/애플리케이션이 Kraken 비공개 API 키를 요구하는 한 잠재적인 보안 문제가 있을 수 있지만, 잔액 및/또는 원장을 읽는 것과 같이 최소한의 권한으로 특정 API 키를 생성하는 한 자금이나 전반적인 보안에 대한 위험은 없습니다. 이러한 이유로 읽기 전용 권한을 부여하고 해당 권한을 가진 특정 API 키를 생성하여 신뢰할 수 있는 타사 소프트웨어와 공유하는 것이 좋습니다.


더 많은 도움이 필요하신가요?