고급 API FAQ

REST API 펀딩 엔드포인트를 사용하여 고객은 Kraken 계정으로 자금을 입금/출금하고 입금/출금 거래의 실시간 상태를 요청할 수 있습니다.

입금/출금은 초기 요청부터 거래 완료까지 여러 단계를 거치므로, 펀딩 엔드포인트는 호출 시점에 따라 다른 상태 값을 반환합니다.

상태 값은 원래 인터넷 금융 거래 프로토콜(IFEX) 문서의 16/17페이지에서 가져왔지만, 암호화폐 거래에 더 적합하도록 약간 수정되었습니다(예를 들어, 가능한 모든 상태 값이 사용되는 것은 아닙니다).

다음은 DepositStatus 엔드포인트의 응답에 위 상태 값이 어떻게 나타나는지에 대한 몇 가지 예시입니다:

Settled 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Success 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

다음은 WithdrawStatus 엔드포인트의 응답에 위 상태 값이 어떻게 나타나는지에 대한 몇 가지 예시입니다:

Initial 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Pending 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Settled 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Success 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Failure 상태:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

입금/출금에 대한 추가 정보는 당사의 현금 펀딩 및 암호화폐 펀딩 지원 페이지에서 확인할 수 있습니다.

REST API OHLC 엔드포인트는 요청된 간격의 720개 데이터 포인트로 제한된 양의 과거 데이터만 제공합니다. 예를 들어, 1분 간격으로 OHLC 데이터를 요청하면 가장 최근 720분(12시간)의 데이터가 반환됩니다.

추가 OHLC 또는 틱 데이터가 필요한 애플리케이션의 경우, REST API Trades 엔드포인트를 통해 당사 시장의 전체 거래 내역(과거 시간 및 판매)을 검색할 수 있습니다. 모든 시간 프레임 및 모든 간격에 대한 OHLC는 과거 시간 및 판매 데이터에서 생성될 수 있습니다.

Trades 엔드포인트는 데이터의 시작 날짜/시간을 지정하는 since라는 선택적 매개변수를 사용합니다. since 값은 나노초 해상도의 UNIX 타임스탬프입니다(9개의 추가 숫자가 있는 표준 초 단위 UNIX 타임스탬프).

예를 들어, https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000와 같은 Trades 엔드포인트 호출은 2019년 6월 1일 00:00:00 UTC부터 XBT/USD의 과거 시간 및 판매를 반환합니다:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Trades 엔드포인트에 대한 후속 호출은 since 매개변수 값을 이전 호출 결과의 last 매개변수 값으로 대체해야 합니다(예: https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117).

특별한 since 값인 0(제로)을 사용하면 시장 시작부터(첫 번째 거래부터) 과거 시간 및 판매를 반환합니다.

사용자 참조는 일부 주문 관리 작업(특히 주문 취소)에서 실제(API 제공) 주문 ID 대신 사용할 수 있는 클라이언트 제공 주문 ID입니다.

사용자 참조는 가능한 한 유연하게 구현되었으므로 다음과 같은 다양한 방식으로 사용될 수 있습니다:

사용자 참조는 1에서 2,147,483,647 사이의 숫자 값(본질적으로 모든 양의 32비트 숫자)이어야 하며, 따라서 간단한 카운터, 임의의 부호 있는 32비트 값 또는 초 단위 타임스탬프로 구현될 수 있습니다(단, 이는 2038년 1월 19일 3:14:07 UTC 이후에는 실패합니다).

이 문제는 Cloudflare와 관련이 있을 수 있습니다:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

참고: Kraken은 "브라우저 무결성 검사"를 활성화했습니다.

요청에 의심스러운 헤더가 포함되어 있는 경우 발생할 수 있습니다. 예를 들어, 요청에 사용자 에이전트가 없거나 비표준 사용자 에이전트를 사용할 수 있으므로 요청 헤더를 확인하십시오.

시스템에서 허용하는 표준 요청을 생성할 수 없는 경우, 시도 중인 요청의 전체 사본(IP 주소 및 모든 헤더 포함)을 보내주십시오. 이 정보는 추가 조사를 가능하게 합니다.

소액의 실제 주문 및/또는 극단적인 가격의 주문

Validate 매개변수를 사용한 포괄적인 API 테스트를 위해, 매우 작은 시장가 주문(최소 주문 규모의 주문) 또는 현재 시장 가격에서 멀리 떨어진 가격으로 지정가 주문(예를 들어, 시장 가격이 $200일 때 ETH/USD를 $800에 매도하는 지정가 주문)을 하는 것을 권장합니다.

실제 주문을 사용한 테스트는 API 코드가 실제 조건에서 저희 API와 상호 작용할 수 있도록 하여, 테스트의 모든 측면이 정확하게 됩니다 (주문이 오더북에 미치는 영향 등).

보안상의 이유로, 최근 TLS 1.0 및 1.1 지원을 중단했습니다. 저희 API에 연결하려고 할 때 SSL/TLS 연결 오류 메시지가 발생하는 경우, 이는 이러한 사용 중단된 표준 중 하나를 사용하고 있기 때문일 가능성이 높습니다. API 클라이언트를 수정하여 TLS 1.2/1.3 사용을 강제하거나, .NET 버전을 4.6 이상으로 업그레이드해야 합니다. 4.6 이상 버전은 TLS 1.2/1.3을 표준으로 사용합니다.

다음 Google Sheet를 사용하여 모든 입력 데이터 조합에 대한 REST API 인증 서명을 계산할 수 있습니다.

이 계산기는 인증 알고리즘이 올바르게 구현되었는지 확인하는 데 사용될 수 있으며, 이를 통해 개발 주기 후반에 발생할 수 있는 잠재적인 문제(특히 예상치 못한 유효하지 않은 키 오류)를 방지할 수 있습니다.

보안상의 이유로, 인증 계산기를 임시 API 키와 함께 사용한 다음, 인증 서명 구현이 올바른 것으로 확인되면 계정에서 API 키를 삭제하는 것을 권장합니다.

저희 클라이언트 라이브러리 래퍼를 사용하는 주된 이점은 API 서명 생성을 위해 바퀴를 재발명하는 데 시간과 노력을 들일 필요가 없다는 것입니다. 이미 다 되어 있습니다.

공개 메서드만 호출할 계획이라면, 인증이 필요 없으므로 클라이언트 라이브러리를 사용하지 않기로 선택할 수 있습니다.

사용 가능한 래퍼 목록은 여기에서 찾을 수 있습니다.