호출 및 반환 (REST API)

최종 업데이트: More than 3 months ago

호출


API 엔드포인트에 액세스하려면 다음 URL로 HTTP 호출을 보내야 합니다.

https://futures.kraken.com/derivatives/api/v3

비공개 엔드포인트 호출의 경우 다음 HTTP 헤더를 제공해야 합니다: apiKey 및
authent. 요청에 nonce를 포함하는 것은 선택 사항입니다.

예시

다음은 Java에서 HTTP 헤더를 포함하는 예시입니다. 다양한 프로그래밍 언어로 된 전체
작동 예시는 샘플 구현 섹션을 참조하십시오. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
...
con.setRequestProperty("APIKey", apiKey);
con.setRequestProperty("Authent", authent); 여기서 apiKey와 authent는 이전에 설명된 대로 결정됩니다.


서버 상태를 변경하지 않는 엔드포인트 호출은 requestType
= GET으로, postData는 URL로 제출해야 합니다. 서버 상태를 변경하는 엔드포인트 호출은 requestType = POST로, postData는 URL로 제출해야 합니다. 각 엔드포인트에 사용해야 하는 requestType에 대한 자세한 내용은 섹션 4를 참조하십시오.

반환


API의 반환값은 JSON 형식입니다. 호출이 성공하면 반환값에는 요청된
정보 또는 요청된 작업에 대한 피드백이 포함됩니다. 각 엔드포인트의 반환값에 대한 설명은 섹션 Error! Reference source not found.를 참조하십시오.

호출이 성공하면 루트 구조의 result 키는 success 값을 가집니다.

비공개 엔드포인트 호출의 경우 다음 HTTP 헤더를 제공해야 합니다: apiKey 및
authent.

예시

다음은 sendorder 엔드포인트 호출이 성공했을 때의 반환값을 보여줍니다.
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"placed",
"order_id":"c18f0c17-9971-40e6-8e5b10df05d422f0"
}
}


호출이 result가 success로 반환되는 경우, 이는 요청이 성공적으로 수신되고 평가되었음을 의미할 뿐입니다. 반드시 원하는 작업이 수행되었음을 의미하지는 않습니다. 작업 상태에 대한 자세한 내용은 해당되는 경우 status 키로 반환됩니다.

예시

다음은 원하는 작업이 수행되지 않은 sendorder 엔드포인트 호출이 성공했을 때의 반환값을 보여줍니다. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

더 많은 도움이 필요하신가요?