Llamadas y respuestas (API REST)

Última actualización: 31 mar 2025

Llamadas


Para acceder a los puntos finales de la API, las llamadas HTTP deben enviarse a la siguiente URL.

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

Para las llamadas a puntos finales privados, se deben proporcionar los siguientes encabezados HTTP: apiKey y
authent. Incluir el nonce en la solicitud es opcional.

Ejemplo

A continuación se muestra un ejemplo de la inclusión de encabezados HTTP en Java. Para ver ejemplos completos
de trabajo en diferentes lenguajes de programación, consulte la Sección Implementaciones de ejemplo. 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); donde apiKey y authent se determinan como se describió anteriormente.


Las llamadas a puntos finales que no cambian el estado del servidor deben enviarse con requestType
= GET y con postData enviado en la URL. Las llamadas a puntos finales que sí cambian el estado del servidor deben enviarse con requestType = POST y con postData enviado en la URL. La Sección 4 detalla para cada punto final qué requestType debe usarse.

Devoluciones


Las devoluciones de la API están en formato JSON. Si la llamada fue exitosa, la devolución incluye la información
solicitada o la retroalimentación sobre la acción solicitada. Consulte la Sección ¡Error! No se encontró la fuente de referencia. para una descripción de las devoluciones para cada punto final.

Si una llamada fue exitosa, la clave de resultado en la estructura raíz tendrá el valor success.

Para las llamadas a puntos finales privados, se deben proporcionar los siguientes encabezados HTTP: apiKey y
authent.

Ejemplo

A continuación se muestra la devolución de una llamada exitosa al punto final 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 devuelve un resultado igual a success, esto simplemente significa que la solicitud ha
sido recibida y evaluada con éxito. No significa necesariamente que la operación deseada se haya realizado. Los detalles sobre el estado de la operación se devuelven en una clave de estado, cuando corresponda.

Ejemplo

A continuación se muestra la respuesta de una llamada exitosa al endpoint sendorder donde la operación deseada no se realizó. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

¿Necesita más ayuda?