Python에서 Kraken Futures API를 어떻게 사용합니까? (개발자 가이드)

인증 자격 증명 설정

1. Kraken 계정에 로그인하고 API 아래의 설정 섹션으로 이동하세요.

2. 선물 거래를 위해 특별히 새로운 API 키 쌍을 생성하고 '선물' 권한이 활성화되었는지 확인하세요.

3. API 키와 개인 키를 안전하게 저장하세요. 절대로 소스 파일에 하드코딩하거나 버전 관리에 커밋하지 마세요.

4. KRAKEN_FUTURES_API_KEY 및 KRAKEN_FUTURES_PRIVATE_KEY 와 같은 환경 변수를 사용하여 런타임에 자격 증명을 삽입합니다.

5. GET /api/v3/accounts 엔드포인트를 통해 계정 잔액을 가져오는 등 최소한의 인증된 요청을 수행하여 키의 유효성을 검사합니다.

필수 라이브러리 설치 및 구성

1. pip: pip install kraken-futures-api 를 사용하여 공식 Kraken Futures Python SDK를 설치합니다.

2. 또는 헤더 및 서명 논리에 대한 세밀한 제어가 필요한 경우 요청을 직접 사용하십시오.

3. 수동 서명 생성을 위해 필요한 모듈인 KrakenFuturesAPI , json 및 base64를 가져옵니다.

4. 귀하의 자격 증명으로 클라이언트를 초기화하십시오: client = KrakenFuturesAPI(key=key, secret=secret) .

5. client.get_server_time()을 호출하고 응답에 유효한 Unix 타임스탬프가 포함되어 있는지 확인하여 연결을 확인합니다.

선물 주문 접수 및 관리

1. 기호(예: PI_XBTUSD ), 측면( 매수 또는 매도 ), 크기 및 주문 유형( 한도 , 시장 , 정지 )을 지정하는 주문 페이로드를 구성합니다.

2. order_id , status 및 filled_size 가 포함된 구조화된 응답을 반환하는 client.send_order(...) 를 사용하여 주문을 제출합니다.

3. client.cancel_order(order_id) 를 사용하여 활성 주문을 취소하고 반환된 JSON에서 취소 상태를 확인하세요.

4. client.get_open_orders() 를 사용하여 미결 주문을 검색하고 필요한 경우 기호 또는 주문 ID로 필터링합니다.

5. client.get_fills() 를 폴링하거나 실행 이벤트에 대해 Kraken의 WebSocket 피드와 통합하여 실시간 채우기를 모니터링합니다.

마진 및 위치 데이터 처리

1. client.get_margin_requirements(symbol='PI_XBTUSD') 를 사용하여 계약당 현재 마진 요구 사항을 가져옵니다.

2. client.get_open_positions() 를 통해 오픈 포지션을 쿼리하고 size , mark_price 및 unrealized_pnl 과 같은 필드를 검사합니다.

3. Kraken의 계층형 마진 규칙에 따라 client.set_leverage(symbol='PI_XBTUSD', 레버리지=5)를 사용하여 포지션에 대한 레버리지를 조정합니다.

4. 현재 규모와 일치하는 반대 시장 주문을 제출하여 명시적으로 포지션을 종료하거나 client.close_position(symbol='PI_XBTUSD') 를 사용하십시오.

5. client.get_account_summary() 에서 청산 위험 지표, 특히 margin_level 및 available_margin 을 구문 분석합니다.

자주 묻는 질문

Q: 현물 및 선물 엔드포인트에 동일한 API 키를 사용할 수 있습니까? A: 아니요. Kraken은 현물 및 선물 서비스에 대해 별도의 API 키가 필요합니다. Spot API 설정에서 생성된 키에는 Futures 권한이 없으며 Futures 엔드포인트에서 HTTP 403을 반환합니다.

Q: 주문 서명이 만료되면 어떻게 되나요? 답변: Kraken은 서명된 요청에 대해 60초의 유효 기간을 적용합니다. Kraken-Api-Key 헤더의 타임스탬프가 서버 시간과 60초 이상 다른 경우 오류 코드 EAPI:Invalid nonce 와 함께 요청이 실패합니다.

Q: 주문 응답의 상태 필드를 어떻게 해석합니까? A: 유효한 값에는 Accepted , Triggered , Cancelled , Filled 및 Expired 가 포함됩니다. 각각은 가격 조건 및 시스템 처리에 따라 관리되는 고유한 수명 주기 단계를 반영합니다.

Q: Futures API에 속도 제한이 있습니까? 답: 그렇습니다. Kraken은 계정 계층 및 엔드포인트 카테고리에 따라 동적 속도 제한을 적용합니다. 제한을 초과하면 HTTP 429가 반환되고 지연 기간(초)을 나타내는 Retry-After 헤더가 포함됩니다.