크라켄 API 사용 방법

크라켄 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 시간의 양초를 반환합니다. 응답에는 시간, 개방, 높음, 낮음, 가까운 및 볼륨 데이터가 포함됩니다. 크라켄은 과거 데이터를 요청 당 최근의 최근 간격으로 제한합니다.