자동 거래를 위해 Kraken API를 사용하는 방법: 개발자 가이드

API 인증 및 키 관리

1. 엄격한 권한 범위로 Kraken의 보안 설정을 통해 API 키를 생성합니다. 꼭 필요한 경우가 아니면 "자금 인출"을 비활성화합니다.

2. 환경 변수 또는 암호화된 저장소에 키를 저장합니다. 절대로 소스 파일에 하드코딩하거나 Git 저장소에 커밋하지 마세요.

3. 90일마다 키를 교체하고 Kraken 제어판을 사용하여 손상된 키를 즉시 취소합니다.

4. 모든 API 엔드포인트에 IP 화이트리스트를 적용하여 알려진 인프라 주소에만 액세스하도록 제한합니다.

5. SHA-256으로 페이로드를 해싱하고 base64로 인코딩된 비밀 키로 서명하여 프라이빗 엔드포인트에 대한 서명된 요청을 사용합니다.

데이터 검색 및 속도 제한 전략

1. /public/Ticker 및 /public/AssetPairs 와 같은 공개 엔드포인트는 인증 없이 초당 최대 15개의 호출을 허용합니다.

2. 프라이빗 엔드포인트는 슬라이딩 창 제한(2초당 요청 20개, X-RateLimit-Remaining 헤더를 통해 추적)을 적용합니다.

3. 계단식 오류를 방지하려면 HTTP 429 응답을 수신할 때 지터를 사용하여 지수 백오프를 구현합니다.

4. 자산 쌍 메타데이터는 거의 변경되지 않으므로 최소 24시간 동안 로컬로 캐시하여 중복 호출을 최대 68%까지 줄입니다.

5. 반복적으로 폴링하는 대신 효율적으로 과거 양초를 가져오기 위해 매개변수를 사용하여 일괄 OHLCV 요청을 수행합니다.

주문 수명주기 구현

1. /private/AddOrder를 통해 필수 필드인 주문 유형 , 유형 , 볼륨 , 쌍 및 지정가 주문 가격 과 함께 주문을 제출합니다.

2. userref를 사용하여 주문 상태 확인 및 거래 내역 조회 전반에 걸쳐 조정을 위한 사용자 정의 식별자를 첨부합니다.

3. userref 로 /private/QueryOrders를 폴링하여 활성 전략 기간 동안 100ms 간격 내에 실행을 확인합니다.

4. 중복 채우기를 방지하려면 교체품을 제출하기 전에 /private/CancelOrder를 사용하여 대기 중인 주문을 취소하세요.

5. descr 및 descr.order 응답 필드를 주의 깊게 구문 분석합니다. 여기에는 가격, 거래량 및 레버리지 플래그에 대해 구문 분석해야 하는 원시 명령 문자열이 포함되어 있습니다.

오류 처리 및 복원력 패턴

1. EAPI:속도 제한 초과를 재시도 조정이 필요한 치명적이지 않은 일시적 오류로 처리합니다. 이는 프로세스 충돌에 대한 예외가 아닙니다.

2. 요청 직렬화 전에 EGeneral:Invalid 인수 와 같은 Kraken 관련 오류 코드를 구조화된 검증 실패에 매핑합니다.

3. 오류 배열이 비어 있지 않은 경우에만 전체 요청/응답 본문을 기록하고 로그에서 key , secret 및 sig 필드를 수정합니다.

4. 현재 시장 스프레드와 설명 가격을 비교하여 오래된 주문 상태를 감지합니다. 편차가 0.5%를 초과하면 수동 확인이 시작됩니다.

5. 5초마다 /public/Depth 를 통해 업데이트되는 지속적인 로컬 주문장 스냅샷을 유지하여 변동폭이 급증하는 동안 채우기 정확성을 교차 점검합니다.

자주 묻는 질문

Q1: Kraken은 실시간 주문장 업데이트를 위해 WebSocket 스트리밍을 지원합니까? 예—Kraken은 WebSocket v2에 book , trade 및 ohlc 채널을 제공합니다. 구독에는 공개 데이터에 대한 인증이 필요하지 않지만 ownTrades 와 같은 비공개 피드에 대한 API 키 바인딩이 필요합니다.

Q2: Kraken은 ADA/USD와 같은 유동성이 낮은 쌍에 대한 부분 주문량을 어떻게 처리합니까? Kraken은 자산 쌍당 최소 볼륨 임계값을 적용합니다. ADA/USD의 경우 최소값은 10 ADA입니다. 이보다 낮은 볼륨은 서명 검증 전에 EInput:Invalid 볼륨 으로 거부됩니다.

Q3: REST API를 통해 직접 손실 중지 주문을 할 수 있나요? 예. /private/AddOrder 에서 ordertype=stop-loss 또는 stop-loss-limit를 사용하세요. 중지 트리거는 입찰/매도 중간점이 아닌 최종 거래 가격을 사용하여 서버 측에서 평가됩니다.

Q4: Kraken API 통합 테스트를 위한 샌드박스 또는 데모 환경이 있습니까? 공식 샌드박스가 존재하지 않습니다. 개발자는 잔고가 없거나 최소한의 자금이 있는 실제 계정을 사용해야 합니다. Kraken은 검증 주기 동안 재정적 노출을 줄이기 위해 XTZ/USD 와 같은 소량 쌍에 대한 테스트를 권장합니다.