Kraken API에서 과거 계약 데이터를 얻으려면 어떻게해야합니까?

크라켄 API 및 역사적 계약 데이터 이해

Kraken API는 개발자와 거래자가 프로그래밍 방식으로 Kraken의 Cryptocurrency Exchange 서비스와 상호 작용할 수있는 강력한 인터페이스입니다. 역사적 계약 데이터를 언급 할 때 크라켄은 주로 크라켄 선물 플랫폼 (이전에 Cryptowatch 파생 상품)을 통해 스팟 거래 및 선물 계약을 지원한다는 것을 명확히하는 것이 중요합니다. 표준 Kraken REST API (API.KRAKEN.COM)는 선물 또는 영구 계약에 대한 역사적 데이터를 직접 제공하지 않습니다. 대신, 역사적 계약 데이터는 Futures-api.kraken.com에서 호스팅 된 Kraken Futures API 를 통해 액세스 할 수 있습니다.

과거 데이터를 검색하려면 필요한 계약 유형 및 시간 프레임에 따라 올바른 엔드 포인트를 식별해야합니다. Kraken Futures API는 /api/history/candles 와 같은 엔드 포인트를 제공하여 특정 선물 계약에 대한 OHLC (개방형, 높음, 낮음, 클로즈) 데이터를 가져옵니다. 각 엔드 포인트는 데이터 범위를 정의하기 위해 기호 , 간격 및 타임 스탬프부터/부터 타임 스탬프까지 의 매개 변수가 필요합니다.

API 액세스 자격 증명 설정

요청을하기 전에 Kraken Futures API에 대한 인증 된 액세스를 설정해야합니다. 여기에는 API 키와 비밀이 포함됩니다.

• 크라켄 계정에 로그인하여 자금 조달 섹션으로 이동하십시오.
• API를 선택하고 크라켄 미래를 선택하십시오.
• API 키 생성을 클릭합니다.
• 권한 할당 - 시장 데이터에 대해서는 읽기 액세스가 활성화되어 있습니다.
• 키를 생성하고 API 키 와 비밀 키를 모두 안전하게 저장하십시오.

이 자격 증명은 HMAC-SHA256을 사용하여 요청에 서명해야합니다. Spot Trading과 달리 Kraken Futures는 별도의 인증 메커니즘을 사용합니다. 모든 요청에는 APIKey 및 Authent 와 같은 헤더가 포함되어야합니다. 여기서 Authent 요청 방법, 경로, 본문 및 타임 스탬프를 기반으로 계산 된 서명입니다.

과거 데이터에 대한 API 요청 구성

역사적 계약 데이터를 검색하려면 Candles History Endpoint를 사용하십시오.

 GET https://futures-api.kraken.com/api/history/candles

필요한 쿼리 매개 변수는 다음과 같습니다.

• 기호 : Bitcoin 영구 역 계약에 대한 PI_XBTUSD 와 같은 계약 기호.
• 간격 : 촛대 간격. 유효한 값은 1m , 5m , 15m , 1h , 4h , 1d 포함합니다.
• 에서 : Unix 타임 스탬프 (초)의 시작 시간.
• TLEAL : UNIX 타임 스탬프 (초)의 종료 시간.

예를 들어, 2024 년 1 월 1 일부터 2024 년 1 월 2 일까지 Bitcoin 영구 계약에 대한 1 시간 촛불을 가져 오려면 :

 https://futures-api.kraken.com/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600

이 요청에는 공개 시장 데이터 만 액세스하면 인증이 필요하지 않습니다. 그러나 속도 제한이면 인증 된 요청을 사용하는 것을 고려하십시오.

요율 제한 요청에 대한 인증 처리

무단 요청 제한을 초과하면 서명 된 요청으로 전환하십시오. 프로세스에는 다음이 포함됩니다.

• 메소드, 경로, 본문 및 ISO 8601 타임 스탬프로 요청 페이로드를 작성합니다.
• 타임 스탬프, 방법, 경로 및 신체 (존재하는 경우)를 서명 문자열로 연결합니다.
• 비밀 키와 함께 HMAC-SHA256을 사용하여 서명을 생성합니다.
• Authent 헤더의 서명과 APIKey 의 키를 포함합니다.

Python의 예제 단계 :

• 요청 메소드를 설정하십시오 : GET
• 경로 정의 : /api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• ISO 타임 스탬프 : 2024-01-01T00:00:00Z 생성하십시오
• 서명 메시지를 작성하십시오 : 2024-01-01T00:00:00ZGET/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• 비밀 키를 사용하여 메시지의 HMAC-SHA256을 계산하십시오
• Base64에서 결과를 인코딩하십시오
• 헤더 설정 :
  • APIKey: YOUR_PUBLIC_KEY
  • Authent: BASE64_SIGNATURE
  • Nonce: 2024-01-01T00:00:00Z

requests 같은 라이브러리를 사용하여 요청을 보내십시오.

응답 데이터 처리 및 저장

API는 캔들 객체 배열이 포함 된 JSON 응답을 반환합니다. 각 양초에는 다음이 포함됩니다.

• 타임 스탬프 : 촛불 시작의 유닉스 시간.
• 오픈 : 오픈 가격.
• 높음 : 최고 가격.
• 낮은 가격 : 최저 가격.
• 닫기 : 마감 가격.
• 볼륨 : 거래량.

예제 응답 :

 { 'result': 'success', 'candles': [ { 'timestamp': 1704067200, 'open': '42000.00', 'high': '42500.00', 'low': '41800.00', 'close': '42300.00', 'volume': '120.5' }

]] }

JSON을 구문 분석하고 candles 배열을 추출하십시오. 이 데이터를 CSV, 데이터베이스 또는 분석용 데이터 프레임에 저장할 수 있습니다. 필요에 따라 타임 스탬프가 현지 시간 또는 UTC로 변환되도록하십시오. 시간 범위가 큰 경우 Pagination 처리 - Kraken은 요청 당 결과를 제한 할 수 있으며, 값 from until 조정 된 여러 통화가 필요합니다.

일반적인 오류 및 문제 해결

• 유효하지 않은 기호 : 계약 기호를 다시 확인하십시오. GET /api/instruments 사용하여 사용 가능한 모든 계약을 나열하십시오.
• 요금 제한 : 인증되지 않은 요청은 제한적입니다. 인증을 사용하거나 통화간에 지연을 추가하십시오.
• 유효하지 않은 타임 스탬프 형식 : 유닉스 타임 스탬프가 밀리 초가 아닌 초에 있는지 확인합니다.
• 서명 불일치 : 서명 문자열에 정확한 경로 및 쿼리 매개 변수가 포함되어 있으며 비밀 키가 올바른지 확인합니다.
• 빈 응답 : 시간 범위에 활성 거래 기간이 포함되어 있습니다.

Postman 또는 Python 스크립트와 같은 도구를 사용하여 요청을 점차 테스트하십시오. 요청 헤더 및 디버깅에 대한 응답을 캡처하기 위해 로깅을 활성화하십시오.

자주 묻는 질문

크라켄 선물 계약의 올바른 상징을 어떻게 찾습니까? 계측기 끝점 사용 : GET https://futures-api.kraken.com/api/instruments 이것은 Bitcoin 영구에 대한 PI_XBTUSD 또는 에테르 미래에 대한 FI_ETHUSD 와 같은 모든 활성 계약을 그들의 기호로 반환합니다.

양초 대신 진드기 수준의 역사적 데이터를 검색 할 수 있습니까? 크라켄 선물 API는 공개 엔드 포인트를 통해 진드기 수준 데이터를 제공하지 않습니다. /api/history/candles Endpoint는 지정된 간격으로 집계 된 OHLC 데이터 만 지원합니다. 세분화 된 데이터의 경우 WebSocket 피드 또는 타사 데이터 제공 업체를 고려하십시오.

한 번에 얼마나 많은 역사적 데이터를 가져올 수 있는지에 대한 제한이 있습니까? 예, API는 요청 당 반환 된 양초 수를 제한 할 수 있습니다. 시간 범위가 크면 한 번에 하루 씩 더 작은 간격으로 나누고 여러 요청을하십시오. 완전성에 대한 응답을 확인하고 그에 until from 변수를 조정하십시오.

역사적 계약 데이터에 액세스하려면 검증 된 Kraken 사용자 여야합니까? 인증되지 않은 공개 데이터 요청의 경우 기본 계정 액세스로 충분합니다. 그러나 요금 제한을 높이고 안정적인 액세스를 보장하기 위해 API 자격 증명이있는 검증 된 계정을 권장합니다. 데이터 검색에는 전체 거래 권한이 필요하지 않습니다.