크라켄 선물 API 튜토리얼

Kraken Futures API는 안전한 인증, 실시간 데이터 및 주문 관리를 통해 자동 거래를 가능하게합니다.

2025/07/26 23:28

크라켄 미래와 API 생태계 이해

Kraken Futures API는 Kraken의 파생 상품 시장에 자동으로 액세스 할 수있는 트레이더 및 개발자를 위해 설계된 강력한 도구입니다. 스팟 거래와 달리 선물은 사용자가 레버리지를 사용하여 암호 화폐의 가격 변동을 추측 할 수 있도록합니다. Kraken Futures API는 주문 제기, 시장 데이터 검색, 직책 관리 및 계정 상태를 프로그래밍 방식으로 모니터링하기위한 엔드 포인트를 제공합니다. 이 API는 HTTPS 및 WebSocket 프로토콜을 통해 작동하므로 REST 기반 요청 및 실시간 데이터 스트리밍이 가능합니다.

API와 상호 작용하려면 먼저 futures.kraken.com 의 생산 환경과 demo-futures.kraken.com 의 샌드 박스 테스트 환경 인 두 가지 주요 환경을 이해해야합니다. 샌드 박스를 통해 개발자는 실제 자금을 위험에 빠뜨리지 않고 전략을 테스트 할 수 있습니다. 모든 엔드 포인트에는 Kraken Futures Account Dashboard를 통해 생성되는 API 키 및 비밀을 사용하여 인증이 필요합니다.

개인 엔드 포인트에 대한 각 요청에는 3 개의 헤더가 포함되어야합니다.

• Apikey : 공개 API 키
• 인증 : 비밀 키에서 생성 된 SHA256 HMAC 서명
• NONCE : 독특하고 증가하는 숫자 또는 타임 스탬프

이러한 보안 조치를 통해 승인 된 사용자 만 주문 배치 또는 자금 인출과 같은 작업을 수행 할 수 있습니다.

크라켄 선물 API 자격 증명 설정

API 호출을하기 전에 크라켄 선물 계정 내에서 유효한 자격 증명을 생성해야합니다. 크라켄 선물 대시 보드의 API 관리 섹션 으로 이동하십시오. 개발 요구에 따라 올바른 환경 (라이브 또는 데모)에 로그인했는지 확인하십시오.

• '새 키 생성'을 클릭하십시오.
• 쉽게 식별하기 위해 API 키에 설명 이름을 할당하십시오.
• 적절한 권한 선택 : 주문 배치 , 읽기 잔액 및 보기 위치
• 추가 보안에 필요한 경우 IP 화이트리스트를 활성화하십시오
• 생성 과정을 확인하십시오

완료되면 API 키 (긴 영숫자 문자열)와 개인 비밀의 두 가지 중요한 구성 요소가 제공됩니다. 이것들을 단단히 보관하십시오. 대화 상자를 닫은 후 비밀은 다시 표시되지 않습니다. 그것을 잃으면 열쇠를 취소하고 재생해야한다는 의미입니다.

테스트 목적으로 샌드 박스 환경을 사용하여 라이브 시장에서 의도하지 않은 거래를 피하십시오. 환경간에 전환 할 때 기본 URL을 그에 따라 업데이트합니다.

• 샌드 박스 : https://demo-futures.kraken.com
• 라이브 : https://futures.kraken.com

개인 엔드 포인트에 대한 인증 메커니즘

/orders , /positions 또는 /account 과 같은 개인 종료점에 액세스하려면 적절한 인증이 필요합니다. 이 프로세스의 핵심은 유효한 HMAC-SHA256 서명을 생성하는 데 있습니다. 이 서명은 개인 비밀에서 파생되며 요청 경로, Nonce 및 신체 (해당되는 경우)가 포함됩니다.

인증 헤더를 단계별로 구성하는 방법은 다음과 같습니다.

• 현재 UNIX 타임 스탬프 (NONE), 요청 경로 (예 : /api/v3/leads/status ) 및 요청 본문 (POST/PUT)을 단일 문자열로 연결합니다.
• 개인 비밀을 사용 하여이 연결된 문자열의 HMAC-SHA256 해시를 계산하십시오.
• 결과 해시를 Base64 형식으로 인코딩하십시오
• Authentification 헤더 에이 인코딩 된 값을 포함하십시오

파이썬 예 :

 import hmac
 import hashlib
 import time nonce = str (int (time.time () * 1000))
 Path = '/API/V3/Orders'
 body = '{'ordertype ':'lmt ','symbol ':'pi_xbtusd ','side ':'buy ','size ': 1000,'limitprice ': 30000}'


메시지 = nonce + path + body
 서명 = hmac.new (

b'your_private_secret_here', msg=message.encode(), digestmod=hashlib.sha256
 ).요람()
 
Auth_header = base64.b64encode (signature) .decode ()

이 서명은 APIKey 및 Nonce 와 함께 모든 개인 요청에 포함되어야합니다.

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

인증이되면 거래 엔드 포인트와 상호 작용을 시작할 수 있습니다. 새 주문을하려면 /api/v3/sendorder 에 게시물 요청을 보내십시오. 페이로드에는 기호, 측면, 크기 및 주문 유형과 같은 필수 매개 변수가 포함되어야합니다.

JSON 본체의 필수 필드 :

• OrderType : lmt (Limit), mkt (시장) 또는 post (사후 제한) 일 수 있습니다.
• 기호 : 예를 들어, pi_xbtusd PERPETUAL Bitcoin/USD 계약
• 측면 : buy 또는 sell
• 크기 : 계약 수 (대부분의 쌍의 최소 1)
• LimitPrice : 제한 주문에 필요합니다

CURL을 사용한 요청 예제 :

 curl -X POST https://futures.kraken.com/api/v3/sendorder \
 -H 'APIKey: your_api_key_here' \
 -H 'Nonce: 1234567890' \
 -H 'Authentification: generated_signature_here' \
 -d '{'orderType':'lmt','symbol':'pi_xbtusd','side':'buy','size':100,'limitPrice':35000}'

제출 후 API는 orderId , 상태 및 기타 메타 데이터를 포함하는 응답을 반환합니다. 이 ID를 사용하여 나중에 주문을 취소하거나 쿼리 할 수 있습니다.

시장 데이터 및 계정 정보 검색

공개 엔드 포인트는 인증이 필요하지 않으며 실시간 시장 조건을 가져 오는 데 이상적입니다. 유용한 엔드 포인트는 다음과 같습니다.

• GET /api/v3/tickers : 모든 기호에 대한 최신 가격, 자금 조달 요율 및 개방형이자를 반환합니다.
• GET /api/v3/orderbook?symbol=pi_xbtusd : 전체 레벨 2 주문서를 가져옵니다
• GET /api/v3/history?symbol=pi_xbtusd&lastTime=... : 최근 무역 기록을 검색합니다

계정 별 데이터의 경우 개인 엔드 포인트를 사용하십시오.

• GET /api/v3/accounts : 모든 원장에 마진 잔액, 지분 및 PNL 표시
• GET /api/v3/positions : 진입 가격, 규모 및 청산 수준이있는 모든 활성 위치를 나열합니다.
• GET /api/v3/orders : 공개 주문을 검색합니다. 추가 ?order_status=closed

모든 응답은 JSON 형식으로되어있어 코드를 쉽게 구문 분석 할 수 있습니다. 폴링 간격은 금리 제한을 존중해야합니다. 일반적으로 공개 엔드 포인트의 경우 초당 10 번의 요청, 개인은 5 개입니다.

오류 처리 및 API 호출 디버깅

올바른 구문을 사용하더라도 API 요청은 잘못된 매개 변수, 마진이 불충분하거나 연결 문제로 인해 실패 할 수 있습니다. 일반적인 HTTP 상태 코드에는 다음이 포함됩니다.

• 400 불량 요청 : 기형 JSON 또는 필수 필드 누락
• 401 무단 : 유효하지 않은 API 키 또는 실패 서명 검증
• 403 금지 : IP는 화이트리스트가 없거나 불충분 한 권한이 없습니다
• 429 너무 많은 요청 : 요율 제한이 초과되었습니다

오류 응답에는 code 및 error 메시지가 포함됩니다. 예를 들어, 'error': 'Invalid signature' HMAC 계산에서 불일치를 나타냅니다. 연결 논리 및 인코딩 단계를 다시 확인하십시오.

개발 중에 원시 요청 및 응답의 로깅을 활성화합니다. -v 플래그가 포함 된 우체부 또는 컬과 같은 도구는 헤더 및 페이로드를 검사하는 데 도움이됩니다. 타임 스탬프를 확인하십시오. Kraken의 서버 시간의 작은 창 (일반적으로 ± 60 초) 내에 있어야하며 GET /api/v3/time 통해 검색 할 수 있습니다.

---

자주 묻는 질문

선물 계약에 대한 올바른 상징을 어떻게 찾습니까?

기호는 특정 명명 규칙을 따릅니다. 영구는 pi_ 로 시작하고 기본 및 인용 통화 (예 : pi_ethusd )로 시작합니다. 분기 별 선물은 f_ 접두사를 사용하고 만료 날짜를 포함합니다 (예 : f_xbtusd_240628 ). 전체 목록을 확인하는 /api/v3/instruments 확인하십시오.

지점과 선물 거래에 동일한 API 키를 사용할 수 있습니까?

크라켄 스팟 및 선물 플랫폼은 별도의 시스템에서 작동합니다. Main Kraken.com 인터페이스가 아닌 Kraken Futures Dashboard 에서 별개의 API 키를 생성해야합니다.

크라켄 미래의 최소 주문 크기는 얼마입니까?

대부분의 영구 계약은 최소 주문 규모가 1 계약입니다. 하나의 계약은 일반적으로 기본 자산의 $ 1과 같습니다. pi_xbtusd 의 경우 1 계약 = $ 1 Bitcoin. 항상 /api/v3/instruments 통해 확인하십시오.

Kraken Futures에서 WebSocket 지원을 사용할 수 있습니까?

예. 주문서, 거래 및 개인 주문 이벤트에 대한 라이브 업데이트를 위해 wss://futures.kraken.com/ws/v1 에 연결하십시오. 인증에는 /api/v3/auth/token endpoint에서 얻은 token 보내는 것이 포함됩니다.