Kraken Pro에서 API 키를 생성하는 방법

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

API 키는 API 인증의 주요 구성 요소 중 하나입니다. 이는 Kraken 계정의 사용자 이름과 비밀번호에 해당하는 API입니다.

API 키는 계정별(즉, 비공개) API 엔드포인트, 즉 계정 관리, 거래, 자금 조달, 수익 엔드포인트를 호출하는 데 필요합니다. 시장 데이터 엔드포인트는 특정 Kraken 계정과 연결되어 있지 않으므로 시장 데이터(즉, 공개) API 엔드포인트를 호출하는 데 API 키가 필요하지 않습니다.

API 키는 REST API 명령줄 클라이언트, 일부 모바일 앱, 타사 거래 봇 및 기타 여러 제품/서비스와 같이 당사 시장 및 계정과 상호 작용하는 모든 소프트웨어에서 사용할 수 있습니다.

API 키 생성

•
Kraken Pro에서 Kraken 계정에 로그인하십시오.
•
계정 메뉴를 엽니다(페이지 오른쪽 상단에 있는 사람 아이콘을 클릭).
•
설정 옵션을 선택합니다.

•
API 탭으로 이동한 다음 "API 키 생성"을 클릭합니다(다음 단계에서 API 키를 구성할 수 있습니다).

API 키 구성

API 키를 사용하려면 이름/설명 및 액세스 권한을 포함한 여러 설정 및 옵션을 구성해야 합니다.

키 이름

키 이름은 본질적으로 API 키의 이름이며, 설명이 고유한 경우(동일한 계정의 다른 API 키 설명과 다른 경우) 원하는 거의 모든 것이 될 수 있습니다.

민감한 정보를 노출하지 않고 API 키에 설명적인 이름을 지정하는 것이 가장 좋습니다(예: "거래 키", "계정 관리 키", "Python API 키 6" 또는 "모바일 앱 키").

키 권한

키 권한은 API 키가 호출할 수 있는 계정별(비공개) API 엔드포인트를 결정합니다.

자금

•
자금 조회는 Balance 및 TradeBalance와 같이 계정 잔액 정보를 조회하는 API 엔드포인트에 필요합니다.
•
자금 입금은 DepositMethods 및 DepositAddresses와 같이 입금과 관련된 자금 조달 엔드포인트에 필요합니다.
•
자금 출금은 WithdrawInfo, Withdraw 및 WithdrawCancel과 같이 출금과 관련된 자금 조달 엔드포인트에 필요합니다.

주문 및 거래

•
미체결 주문 및 거래 조회는 OpenOrders, QueryOrders 및 OpenPositions와 같이 이미 존재하는 주문 및 마진 포지션을 조회하는 API 엔드포인트에 필요합니다.
•
체결/취소된 주문 및 거래 조회는 ClosedOrders, QueryOrders 및 QueryTrades와 같이 이전에 체결/취소된 주문 및 마진 포지션을 조회하는 엔드포인트에 필요합니다.
•
주문 수정은 AddOrder, EditOrder 및 AddOrderBatch와 같이 새로운 주문을 하는 거래 엔드포인트에 필요합니다.
•
주문 취소/종료는 CancelOrder, CancelAll 및 CancelOrderBatch와 같이 미체결 또는 보류 중인 주문을 취소하는 거래 엔드포인트에 필요합니다.

데이터

•
원장 항목 조회는 Ledgers 및 QueryLedgers와 같이 계정 원장에서 과거 계정 데이터를 검색하는 API 엔드포인트에 필요합니다.
•
데이터 내보내기는 AddExport, RetrieveExport, ExportStatus 및 RemoveExport와 같이 계정 원장을 내보내는(다운로드) 엔드포인트에 필요합니다.

API 키 권한을 올바르게 사용하는 예시로, 거래 목적으로 타사에 제공되는 API 키를 고려해 보십시오. 이러한 API 키는 주문 수정 및 주문 취소/종료 권한이 반드시 필요하며, 미체결 주문 및 거래 조회 권한이 필요할 수 있지만, 자금 출금 권한은 거의 확실히 필요하지 않습니다.

권한을 적절하게 구성하면 API 클라이언트가 계정에 대한 거래를 할 수 있지만, API 클라이언트가 계정 정보에 액세스하거나 자금 조달 작업을 수행하는 것을 방지할 수 있습니다.

선택적 설정

나머지 API 키 설정은 고급 구성에만 필요하므로 일반적으로 기본값을 유지할 수 있습니다.

•
WebSocket 인터페이스는 GetWebSocketsToken 엔드포인트를 통해 WebSocket API에 대한 인증 토큰을 검색하는 데 필요합니다.
•
IP 주소 제한은 API 키 사용을 특정 클라이언트 측 IP 주소로 제한하는 보안 기능입니다.
•
키 만료는 특정 기간 동안만 작동하는 API 키를 생성하는 데 사용할 수 있습니다(예: 1주일 동안만 유효한 키).
•
조회 시작/종료 날짜/시간은 과거 계정 데이터 요청을 특정 기간으로 제한하는 설정입니다(예: 올해의 거래 내역은 검색할 수 있지만 이전 연도의 내역은 검색할 수 없는 키).
•
사용자 지정 Nonce Window는 유효하지 않은 nonce(이전에 사용된 nonce 값보다 낮은 nonce 값)를 가진 API 요청이 유효하지 않은 nonce 오류를 발생시키지 않는 짧은 시간(1초, 10초 등)을 제공하여 API 요청이 순서대로 도착하지 않을 수 있는 네트워크 문제를 극복하는 데 사용되는 설정입니다.

API 키 설정이 적절하게 구성되면 키 생성 버튼을 클릭하여 새 API 키를 생성할 수 있습니다.

API 키, 비공개 키 및 QR 코드는 사용자 이름/비밀번호와 동일하게 취급해야 합니다. 나중에 다시 액세스해야 하는 경우 암호 관리자에 저장하십시오. 암호화되지 않은 형식으로 저장하지 마십시오!

API 키 사용

API 키는 공개 및 비공개 키 쌍으로 구성되며, 둘 다 API 클라이언트 소프트웨어에 제공되어야 합니다.

API 키는 다음과 같은 다양한 방법으로 제공될 수 있습니다.

•
키 페어는 API 클라이언트 코드에 일반 텍스트로 직접 복사하여 붙여넣을 수 있습니다. 예시: 당사의 PHP API 클라이언트에서 사용되는 방식.
•
키 페어는 API 클라이언트가 액세스할 수 있는 일반 텍스트 파일에 복사하여 붙여넣을 수 있습니다. 예시: 당사의 명령줄 API 클라이언트에서 사용되는 방식.

참고: 일부 API 클라이언트 소프트웨어에서는 프라이빗 키를 API 시크릿(또는 단순히 시크릿)이라고도 합니다.