크라켄 API 사용 방법

Kraken API는 REST 및 WebSocket을 통해 자동 거래 및 실시간 시장 데이터 액세스를 가능하게하며, 데이터에 대한 공개 엔드 포인트 및 계정 조치에 대한 개인 엔드 포인트가 가능합니다.

2025/08/02 10:28

크라켄 API와 그 목적을 이해합니다

크라켄 API는 개발자와 트레이더가 프로그래밍 방식으로 크라켄 암호 화폐 교환과 상호 작용할 수있는 강력한 도구입니다. 웹 인터페이스에 의존하지 않고 자동 거래, 포트폴리오 관리, 실시간 시장 데이터 검색 및 계정 모니터링이 가능합니다. API는 시세 정보, 주문서 및 무역 이력과 같은 시장 데이터를 제공하는 공개 엔드 포인트 와 인증이 필요한 개인 엔드 포인트를 제공하며 사용자가 주문을 관리하고 균형을 확인하고 자금을 인출 할 수 있도록합니다.

크라켄 API를 효과적으로 사용하려면 REST API 와 WebSockets API 의 두 가지 주요 구성 요소를 이해해야합니다. REST API는 자산 가격을 가져 오거나 주문하는 것과 같은 일회성 요청에 이상적입니다. WebSockets API는 라이브 가격 업데이트 또는 주문서 변경과 같은 실시간 데이터 스트리밍에 사용됩니다. 두 API는 각각 HTTPS 및 WebSocket 연결을 통해 액세스 할 수 있으며 일반적으로 JSON 형식으로 요청 및 응답의 적절한 형식이 필요합니다.

크라켄 API 자격 증명을 설정합니다

API 호출을하기 전에 Kraken 계정에서 API 키와 비밀을 생성해야합니다. 크라켄 계정에 로그인하여 설정 섹션으로 이동하십시오. API 탭을 클릭 한 다음 새 API 키를 선택하십시오. 키에 대한 권한을 설정하라는 메시지가 표시됩니다. 기본 데이터 검색의 경우 쿼리 공개 및 쿼리 개인 옵션을 활성화하십시오. 거래를하거나 자금을 인출 할 계획이라면 거래를 가능하게하고 허가를 철회하십시오 . 손상된 키가 자금 손실로 이어질 수 있으므로 권한에주의하십시오.

키가 생성되면 두 개의 문자열이 표시됩니다.

• API 키 : 계정을 식별하는 데 사용되는 긴 영숫자 문자열입니다.
• API 비밀 : 요청에 서명하는 데 사용되는 Base64에 인코딩 된 문자열입니다.

이것들을 단단히 보관하십시오. API 비밀은 클라이언트 측 코드 또는 공개 리포지토리에 노출되어서는 안됩니다. API 요청에 이러한 자격 증명을 사용하려면 API 비밀을 키로 사용하고 URI Path, Nonce 및 Post Data를 포함하는 메시지와 함께 HMAC-SHA512 암호화를 사용하여 각 개인 요청에 서명해야합니다.

공개 API 요청 실행

공개 엔드 포인트에는 인증이 필요하지 않으며 HTTP GET 요청을 통해 직접 액세스 할 수 있습니다. 시장 데이터를 검색하는 데 유용합니다. 예를 들어, 미국 달러 (BTC/USD)에 대한 Bitcoin에 대한 현재 시세 정보를 얻으려면 다음 엔드 포인트를 사용하십시오.

 https://api.kraken.com/0/public/Ticker?pair=XXBTZUSD

응답에는 마지막 거래 가격 , 24 시간 볼륨 , 높은/저렴한 가격 및 입찰/요청 요금이 포함됩니다. 다른 공개 엔드 포인트는 다음과 같습니다.

• AssetPairs : 모든 거래 가능한 쌍 및 사양을 나열합니다.
• 깊이 : 주어진 쌍의 현재 주문서를 반환합니다.
• 거래 : 최근 무역 이력을 검색합니다.
• OHLC : 차트를위한 촛대 데이터를 제공합니다.

각 공개 요청은 데이터가 포함 된 result 필드와 문제를 나열하는 error 필드로 JSON 객체를 반환합니다. 결과를 처리하기 전에 error 배열을 확인하여 응용 프로그램이 오류를 우아하게 처리하는지 확인하십시오.

개인 API 요청에 서명 및 발송

개인 API 호출은 API 키 와 암호화 서명을 사용한 인증이 필요합니다. 모든 요청에는 다음 헤더가 포함되어야합니다.

• API-Key : 생성 된 API 키.
• API-Sign : 메시지의 HMAC-SHA512 서명.

서명 할 메시지는 다음으로 구성됩니다.

• URI 경로 (예 : /0/private/Balance ).
• Nonce 값 - 한 번 사용되는 엄격하게 증가하는 정수.
• 게시물 데이터 (예 : nonce=1234567890 ).

서명을 구성하려면 :

• path + SHA256(nonce + POST data) 으로 메시지를 연결합니다.
• 디코딩 된 API 비밀을 HMAC 키로 사용하십시오.
• 연결된 메시지에 HMAC-SHA512를 적용하십시오.

파이썬에서는 다음과 같이 구현할 수 있습니다.

 import hashlib
 import hmac
 import time def get_kraken_signature (urlpath, data, secret) :


postdata = urllib.parse.urlencode(data) encoded = (str(data['nonce']) + postdata).encode() message = urlpath.encode() + hashlib.sha256(encoded).digest() mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512) return base64.b64encode(mac.digest()).decode()
 /0/private/Balance 또는 /0/private/AddOrder 같은 엔드 포인트에 게시 요청을 할 때 API-Sign 헤더 에서이 서명을 사용하십시오.
 
실제 사용 사례 및 코드 예제
 일반적인 사용 사례는 계정 잔액을 확인하는 것입니다. 이것을하기 위해 :
 
https://api.kraken.com/0/private/Balance 에 게시물 요청을 보내십시오.
 포스트 본체에 nonce 포함하십시오.
 API-Key 및 API-Sign 헤더를 설정하십시오.
 또 다른 예는 제한 구매 주문을 작성하는 것입니다.
 
/0/private/AddOrder 엔드 포인트를 사용하십시오.
 pair=XXBTZUSD , type=buy , ordertype=limit , price=30000 및 volume=0.01 과 같은 매개 변수를 포함하십시오.
 Nonce가 이전보다 더 큰지 확인하십시오.
 실시간 데이터의 경우 WebSockets API를 사용하십시오. wss://ws.kraken.com/v2 에 연결하십시오. ticker , book 또는 특정 쌍의 trade 와 같은 채널을 구독하십시오. 예를 들어, 라이브 BTC/USD 거래를 얻으려면 :
 
{
 '방법': '구독',
 '매개 변수': {
 
'channel': 'trade', 'symbol': 'BTC/USD', 'snapshot': true
 }
 }

서버는 무역 업데이트가 발생하는 동안 푸시됩니다. 응용 프로그램에서 이벤트 리스너를 사용하여 들어오는 메시지를 처리합니다.

보안 모범 사례 및 요금 제한

크라켄은 학대를 방지하기 위해 요율 제한을 시행합니다. 공개 엔드 포인트는 IP 당 초당 최대 10 개의 요청을 허용합니다. 개인 엔드 포인트는 API 키 당 초당 15 개의 요청으로 제한됩니다. 이러한 제한을 초과하면 임시 금지가 발생합니다. 이를 피하려면 코드에서 요청 조절기 및 지수 백 오프를 구현하십시오.

보안 향상 :

• API 키에 대한 IP 화이트리스트 사용
• 불필요한 권한 비활성화.
• API 키를 주기적으로 회전합니다.
• API 비밀을 일반 텍스트로 기록하거나 저장하지 마십시오.

휴식 전화에는 항상 https를 사용하고 Websocket에는 WSS를 사용하십시오. 생산 환경에서 SSL 인증서를 확인하십시오.

---

자주 묻는 질문

Kraken API 요청에서 Nonce의 올바른 형식은 무엇입니까?

Nonce는 각 요청에 따라 증가하는 정수 여야합니다. 대부분의 개발자는 마이크로 초에서 Unix 타임 스탬프를 사용합니다. 예를 들어, Python의 int(time.time() * 1000000) 은 독창성과 단조로운 성장을 보장합니다. NONE를 재사용하거나 줄이면 API가 요청을 거부하게됩니다.

실제 자금을 위험에 빠뜨리지 않고 Kraken API를 어떻게 테스트 할 수 있습니까?

크라켄은 샌드 박스 환경을 제공하지 않습니다. 그러나 철회 또는 거래 권한이없는 새 API 키를 생성하고이를 사용하여 균형 쿼리 및 시장 데이터 검색을 테스트 할 수 있습니다. 거래 시뮬레이션의 경우 실제 주문을 보내지 않고 시장 데이터를 가져오고 주문 실행을 현지에서 시뮬레이션하십시오.

'EAPI : Invalid Key'오류를받는 이유는 무엇입니까?

이 오류는 API Key 헤더가 누락되었거나 기형 또는 인식되지 않았 음을 나타냅니다. 키가 Kraken 대시 보드에서 정확히 복사되어 요청 헤더에 포함되어 있음을 두 번 확인하십시오. 또한 여분의 공간이나 라인 브레이크가 없도록하십시오.

Kraken API를 사용하여 역사적 촛대 데이터를 검색 할 수 있습니까?

예. pair 및 interval 매개 변수와 함께 /0/public/OHLC 엔드 포인트를 사용하십시오. 예를 들어, pair=XXBTZUSD&interval=60 1 시간의 양초를 반환합니다. 응답에는 시간, 개방, 높음, 낮음, 가까운 및 볼륨 데이터가 포함됩니다. 크라켄은 과거 데이터를 요청 당 최근의 최근 간격으로 제한합니다.