Kraken 거래 API에서 잘못된 API 서명 오류를 수정하는 방법은 무엇입니까?

Kraken API 서명 요구 사항 이해

1. Kraken은 거래 엔드포인트에 대한 모든 인증된 요청에 대해 엄격한 서명 검증을 시행합니다.

2. 서명은 데이터 요소의 특정 연결에 대해 HMAC-SHA512를 사용하여 계산되어야 합니다.

3. 모든 요청에는 밀리초 단위의 고유한 타임스탬프가 필요하며 서버는 60초보다 오래된 요청을 거부합니다.

4. POST 본문은 서명 기반에 포함되기 전에 URL 인코딩 문자열로 인코딩되어야 합니다.

5. 요청 헤더에 사용된 API 키는 서명에 사용된 비밀과 연결된 키와 일치해야 합니다.

올바른 서명 구성 순서

1. 서명 필드 자체를 제외하고 모든 요청 매개변수를 사전으로 수집합니다.

2. 매개변수 키를 알파벳순으로 정렬하고 key1=value1&key2=value2 형식의 단일 문자열로 연결합니다.

3. 정렬된 매개변수 문자열 앞에 API 엔드포인트 경로(예: /0/private/AddOrder )를 추가합니다.

4. UTF-8을 사용하여 결과 문자열을 인코딩하고 디코딩된 Base64 API 비밀을 키로 사용하여 HMAC-SHA512를 계산합니다.

5. 결과 다이제스트를 Base64로 변환하고 이를 요청 페이로드의 부호 매개변수로 포함합니다.

Python 구현의 일반적인 인코딩 함정

1. Base64로 인코딩된 API 비밀을 hmac.new() 에 전달하기 전에 디코딩하지 못하면 잘못된 출력이 발생합니다.

2. POST 본문을 구성할 때 URL로 인코딩된 양식 데이터 대신 원시 JSON을 사용하면 서명 입력이 일치하지 않습니다.

3. 연결하기 전에 타임스탬프를 문자열로 변환하지 않고 정수로 전달하면 자동 유형 오류가 발생합니다.

4. URL 인코딩 중 한 번, JSON 직렬화 중 한 번, 실수로 매개변수 값을 이중으로 인코딩하면 서명 정렬이 중단됩니다.

5. JSON 페이로드에서 공백 정규화 무시: Kraken은 공백이 없는 간결한 JSON을 기대하므로 구분 기호=(',', ':')를 적용해야 합니다.

헤더 구성 필수 사항

1. API-Key 헤더에는 Kraken 계정 대시보드에 등록된 정확한 API 키 문자열이 포함되어야 합니다.

2. API-Sign 헤더는 Hexdigest 또는 원시 바이트가 아닌 Base64로 인코딩된 HMAC-SHA512 결과를 전달해야 합니다.

3. 모든 개인 끝점에 대해 Content-Type 헤더를 application/x-www-form-urlencoded 로 설정해야 합니다.

4. 헤더에 전달된 타임스탬프는 서명 계산에 사용된 타임스탬프와 정확히 일치해야 하며 반올림이나 잘림은 허용되지 않습니다.

5. 모든 헤더는 대소문자를 구분합니다. api-key 또는 Api-Sign은 인증에 즉시 실패합니다.

잘못된 서명 응답 문제 해결

1. mitmproxy 또는 Wireshark 와 같은 도구를 사용하여 전체 원시 요청 및 응답 본문을 캡처하여 예상 서명 입력과 실제 서명 입력을 비교합니다.

2. Python REPL에서 서명 문자열을 수동으로 재구성하고 각 구성 요소의 바이트 표현이 Kraken의 기대와 일치하는지 확인합니다.

3. 길이를 바이트 단위로 인쇄하여 비밀의 Base64 디코딩을 검증합니다. Kraken 비밀은 SHA512 호환성을 위해 정확히 64바이트로 디코딩됩니다.

4. 인코딩하기 전에 매개변수 값에 숨겨진 문자(예: BOM, 너비가 0인 공백)가 없는지 확인하세요.

5. 비공개 호출을 시도하기 전에 먼저 Kraken의 /0/public/Time 엔드포인트를 테스트하여 타임스탬프 동기화를 확인하세요.

자주 묻는 질문

Q: Kraken에서는 KuCoin처럼 암호 문구를 별도로 서명해야 합니까? 아니요. Kraken은 서명 체계에 암호를 사용하지 않습니다. HMAC 계산에는 API 키와 비밀번호만 포함됩니다.

Q: 여러 요청에서 동일한 서명을 재사용할 수 있습니까? 아니요. 각 서명은 고유한 타임스탬프 및 매개변수 세트에 바인딩됩니다. 서명을 재사용하면 즉시 거부됩니다.

Q: 내 서명이 Postman에서는 작동하지만 Python에서는 실패하는 이유는 무엇입니까? 이는 일반적으로 일관되지 않은 URL 인코딩 동작에서 비롯됩니다. Postman은 값을 자동으로 인코딩하는 반면 Python의 urllib.parse.urlencode()는 명시적으로 구성하지 않는 한 특정 문자의 인코딩을 생략할 수 있습니다.

Q: Kraken API 매개변수 값의 최대 길이가 있습니까? Kraken은 문서화된 하드 제한을 적용하지 않지만 값이 너무 길면 HTTP 전송 또는 내부 구문 분석 중 자동 잘림으로 인해 서명이 잘못 정렬될 수 있습니다.