크라켄 선물 API Python 예제

Kraken Futures API를 통해 거래자는 REST 통화를 통해 선물 거래를 자동화 할 수 있으며 HMAC 서명 요청,`PI_XBTUSD`와 같은 유효한 기호 및 Kraken의 선물 탭에서 API 키를 별도의 API 키를 요구합니다.

2025/07/26 19:29

크라켄 선물 API 란 무엇입니까?

Kraken Futures API는 트레이더와 개발자가 크라켄의 선물 거래 플랫폼과 프로그래밍 방식으로 상호 작용할 수있는 REST 기반 인터페이스입니다. 여기에는 주문 배치, 시장 데이터 검색, 계정 잔액 확인 및 직책 관리가 포함됩니다. 알고리즘 거래자 또는 자동화 된 거래 봇에 이상적입니다. Python에서 사용하려면 먼저 Kraken Futures Account Dashboard에서 API 키와 비밀을 얻어야합니다. 이러한 자격 증명은 코드에 노출을 피하기 위해 환경 변수에 적용 할 수 있도록 안전하게 저장해야합니다.

필요한 파이썬 라이브러리를 설치하는 방법

코드를 작성하기 전에 필요한 라이브러리가 설치되어 있는지 확인하십시오. 가장 중요한 것은 API 자격 증명에 환경 변수를 사용하려는 경우 HTTP 커뮤니케이션 및 python-dotenv 에 대한 requests 입니다. 터미널에서 다음 명령을 실행하십시오.

• pip install requests
• pip install python-dotenv
  

  설치되면 다음과 같이 스크립트에서 가져올 수 있습니다.

   import os
   import requests
   import time
   import hashlib
   import hmac
   from dotenv import load_dotenv

  .env 파일을 사용하여 자격 증명을 저장하는 경우 스크립트 상단에서 load_dotenv() 호출하십시오.

  인증 헤더 설정

  
  Kraken Futures API는 요청에 서명하기 위해 HMAC-SHA256을 사용합니다. 각 개인 엔드 포인트 호출에 대한 서명을 생성해야합니다. 프로세스에는 다음이 포함됩니다.
• Nonce 생성 (초 만에 고유 한 타임 스탬프)
• 요청 경로, Nonce 및 Body를 연결합니다
• API 비밀을 사용하여 메시지를 해시합니다

• APIKey 및 Authent 와 같은 헤더 추가 (서명)
  

  인증을 구성하는 방법은 다음과 같습니다.

   def get_kraken_signature(urlpath, data, secret):
   postdata = data
   encoded = (str(data['nonce']) + postdata).encode()
   message = urlpath.encode() + hashlib.sha256(encoded).digest()
   mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512)
   sigdigest = base64.b64encode(mac.digest())
   return sigdigest.decode()

  이 함수는 인증 헤더 값을 반환합니다.이 값은 주문 배치 또는 잔액을 가져 오는 것과 같은 개인 API 호출에 필요한 인증 헤더 값을 반환합니다.

  API를 통해 선물 주문을 작성합니다

  
  선물 주문을하려면 /derivatives/api/v3/sendorder 엔드 포인트에 사후 요청을 보내야합니다. 다음은 전체 예입니다.

   url = 'https://futures.kraken.com/derivatives/api/v3/sendorder' headers = { 'User-Agent': 'Python API Client', 'APIKey': os.getenv('KRAKEN_API_KEY'), } 데이터 = {
  'OrderType': 'lmt',
  '크기': 1,
  '기호': 'pi_xbtusd',
  '측면': '구매',
  'LimitPrice': '69000.0',
  'cliordid': f'my order {int (time.time ())} ',
  'nonce': str (int (time.time () * 1000)),
  }
  
  
  서명 = get_kraken_signature ( '/sendorder', data, os.getenv ( 'kraken_api_secret'))
  헤더 [ 'Authent'] = 서명
  
  응답 = requests.post (URL, 헤더 = 헤더, 데이터 = 데이터)
  
  The **`cliOrdId`** ensures each order is unique. The **`symbol`** must match Kraken's futures contract naming convention (eg, `pi_xbtusd` for perpetual Bitcoin/USD). 열린 위치 및 계정 정보를 가져 오기
  현재 열린 위치를 검색하려면`/devatives/api/v3/OpenPositions`에 GET 요청을 보내십시오. 몸이 필요하지 않지만 여전히 인증이 필요합니다.
   url = 'https://futures.kraken.com/derivatives/api/v3/openpositions'
   헤더 = {
   'Apikey': os.getenv ( 'kraken_api_key'),
   '사용자 에이전트': 'Python API 클라이언트',
   }
   nonce = str (int (time.time () * 1000))
   data = { 'nonce': nonce}
   서명 = get_kraken_signature ( '/Openpositions', data, os.getenv ( 'kraken_api_secret'))
   헤더 [ 'Authent'] = 서명
   

응답 = requests.get (URL, 헤더 = 헤더)
위치 = response.json ()

positions 변수에는 진입 가격, 규모 및 실현되지 않은 P & L을 포함한 활성 위치 목록이 포함됩니다.

일반적인 오류 및 수정 방법

• 유효하지 않은 서명 : 서명 함수에서 연결 논리를 다시 확인하십시오. nonce 문자열인지 확인하고 데이터 페이로드의 것과 일치하십시오.
• 불충분 한 마진 : 계정에 마진이없는 경우 크라켄이 주문을 거부 할 수 있습니다. 먼저 사용 /accountsummary 을 확인하십시오.
• 유효하지 않은 기호 : 유효한 선물 계약 목록을 가져 오기 위해 사용 /instruments . 명명 패턴을 가정하지 마십시오.
• 요율 제한 : 크라켄은 요율 제한을 시행합니다. 429 오류가 발생하면 time.sleep(1) 사용하여 요청 사이에 지연을 추가하십시오.
  

  자주 묻는 질문

  BTC/USD의 올바른 선물 상징을 어떻게 찾습니까?
  
  /instruments endpoint : GET https://futures.kraken.com/derivatives/api/v3/instruments 사용하십시오. usd 로 끝나는 기호를 찾으십시오 - 가장 흔한 것은 영구 선물 계약에 대한 pi_xbtusd 입니다.

  SPOT 및 선물 거래에 동일한 API 키를 사용할 수 있습니까?
  
  크라켄 미래에는 크라켄 계정의 선물 탭 에서 생성 된 별도의 API 키가 필요합니다. 스팟 키를 사용하면 인증 오류가 반환됩니다.

  올바른 매개 변수로 인해 주문이 거부되는 이유는 무엇입니까?
  
  주문 크기가 최소값 (예 : BTC/USD의 경우 0.001 BTC) 이하인지 확인하십시오. 또한 limitPrice Mark 가격과의 허용 편차 내에 있는지 확인하십시오. Kraken은 현재 시장에서 너무 멀리 주문을 거부 할 수 있습니다.

  환경 변수에 API 키를 저장하는 것이 안전합니까?
  
  예, .env 파일이 공개 리포지토리에 전념하지 않는 한. .gitignore 파일에 항상 .env 추가하고 코드에 API 키를 인쇄하거나 로그인하지 마십시오.