Llamadas
Para acceder a los endpoints de la API, las llamadas HTTP deben ser enviadas a la siguiente URL.
https://futures.kraken.com/derivatives/api/v3 |
|---|
Para llamadas de endpoints privados, se deben proporcionar las siguientes cabeceras HTTP: apiKey, nonce, y authent.
Ejemplo | |
|---|---|
A continuación, se muestra un ejemplo para la inclusión de cabeceras HTTP en Java. Para ejemplos de trabajo completos en diferentes lenguajes de programación, consulte la sección Implementaciones de muestra.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("Nonce", nonce); con.setRequestProperty("Authent", authent);donde apiKey, nonce, y authent se determinan como se describió anteriormente. |
Las llamadas a los endpoints que no cambian el estado del servidor deben enviarse con requestType = GET y con postData que se envían en la URL. Las llamadas a los endpoints que cambian el estado del servidor deben enviarse con requestType = POST y con postData que se envían en la URL. La sección 4 detalla qué requestType debe usarse para cada endpoint.
Respuestas
Las respuestas de la API vienen en formato JSON. Si el llamado es exitoso, la respuesta incluye la información
solicitada o comentarios en la acción solicitada. Para la descripción de respuestas para cada endpoint, consulte la sección ¡Error! No se encontró la fuente de referencia.
Si un llamado fue exitoso, la clave resultante en la estructura raíz tendrá el valor success.
Para llamados de endpoints privados, las siguientes cabeceras HTTP deben ser proporcionadas: apiKey, nonce, y
authent.
authent.
Ejemplo | |
|---|---|
A continuación se muestra la respuesta a un llamado exitoso al endpoint 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" } } |
Tenga en cuenta que si una llamada regresa con un resultado igual a success, esto simplemente significa que la solicitud ha
sido recibida y evaluada exitosamente. No significa necesariamente que se haya realizado la operación deseada. Los detalles sobre el estado de la operación se devuelven como una clave de status, cuando corresponde.
Ejemplo | |
|---|---|
A continuación se muestra la respuesta a una llamada exitosa de un endpoint sendorder donde la operación deseada no fue realizada.{ "result":"success", "serverTime":"2016-02-25T09:45:53.818Z", "sendStatus":{ "receivedTime":"2016-02-25T09:45:53.601Z", "status":"insufficientAvailableFunds" } } |