API WebSocket de Kraken - Preguntas frecuentes

¿Kraken tiene una API WebSocket? ¿Cómo puedo conectarme a ella?

Kraken tiene una API REST y una API WebSocket. Nuestra API WebSocket está disponible en las siguientes URL seguras:

Fuentes de datos de mercado públicas (no autenticadas): wss://ws.kraken.com/

Fuentes de datos de cuenta privadas (autenticadas) y puntos finales de trading: wss://ws-auth.kraken.com/

No se requiere autenticación para conectarse a las fuentes de datos de mercado públicas, pero se necesita un token de autenticación válido para las fuentes privadas.

Todos los mensajes enviados y recibidos a través de la API WebSocket son texto plano codificado en formato JSON. Los detalles de cada tipo de mensaje se proporcionan en nuestra documentación de la API WebSocket.

¿Tienen bibliotecas WebSocket disponibles?

Tenemos una variedad de código de ejemplo de la API WebSocket disponible, que se puede usar directamente o como punto de partida para su propia implementación:

Nuestra API WebSocket se puede implementar en cualquier lenguaje de programación que prefiera, y nuestro equipo de soporte de API estará encantado de ayudarle o proporcionarle código de ejemplo en idiomas adicionales si es necesario.

¿Qué fuentes/puntos finales son compatibles?

Nuestra API WebSocket proporciona una variedad de fuentes de datos de mercado en tiempo real, fuentes de datos de cuenta y puntos finales de trading. Una lista completa de las fuentes/puntos finales disponibles, junto con los detalles de implementación para cada fuente/punto final, se puede encontrar en nuestra documentación de la API WebSocket.

¿Cómo sé si estoy conectado correctamente? ¿Cómo sé si sigo conectado?

Cuando se suscribe a una fuente, se recibirá un mensaje {u'event': u'heartbeat'} con una frecuencia de 1 latido por segundo.

No se recibirán latidos si se reciben otros mensajes (datos de mercado, datos de cuenta, etc.) en su lugar. Cuándo y por qué se reciben datos de mercado o de cuenta depende de la fuente a la que esté suscrito.

Si se suscribe a la fuente de un par de divisas con bajo volumen de trading, es posible que solo reciba latidos durante largos períodos.

Si cancela la suscripción a una fuente, ya no recibirá latidos ni datos de trading y, después de no estar suscrito a ninguna fuente durante 1 minuto, se desconectará de la fuente de WebSockets.

¿Cuándo y por qué el WebSocket envía datos actualizados?

Cuándo y por qué se reciben datos de mercado o de cuenta depende de la fuente a la que esté suscrito. Por ejemplo:

Ticker: Cuando hay una operación o un lote de operaciones para un par de divisas, se publica un mensaje de ticker para ese par. Solo recibirá este mensaje si está suscrito a la fuente de ticker para este par.

Trade: De manera similar, cuando hay una operación o un lote de operaciones para un par de divisas, también se publica un mensaje de operación para ese par. Solo recibirá este mensaje si está suscrito a la fuente de operaciones para este par.

OHLC: Se publica un intervalo OHLC actualizado para cada intervalo cuando se ejecuta una operación o un lote de operaciones para un par de divisas. Solo recibirá actualizaciones para los intervalos a los que esté suscrito. Después de cruzar un límite de intervalo, no se envía ningún mensaje hasta que se produce la siguiente operación.

Book: Se publica una instantánea inicial del libro de órdenes con la profundidad elegida cuando se suscribe por primera vez a la fuente del libro.

A medida que se añaden nuevas órdenes al libro de órdenes o se ejecutan operaciones que afectan la profundidad del libro de órdenes a la que está suscrito, se publica un mensaje que contiene actualizaciones del libro de órdenes para cualquier nivel de precio y volumen afectados. Estas actualizaciones pueden contener solo ofertas, solo demandas o ambas. Consulte Cómo construir un libro de órdenes a continuación para obtener más detalles.

Spread: Cuando se realiza una nueva orden de oferta más alta o de demanda más baja, o se ejecuta una operación que cambia el mejor precio de oferta o demanda, se publica un mensaje de spread con los precios de oferta y demanda actualizados.

¿Las fuentes WebSocket proporcionan datos históricos o solo datos actuales?

Las fuentes de datos de mercado de WebSocket solo proporcionan datos actuales; sin embargo, es posible conectarse simultáneamente a la API WebSocket para datos actuales y a la API REST para datos históricos.

Uso del parámetro reqid.

Las solicitudes de suscripción pueden incluir un parámetro reqid proporcionado por el cliente que posteriormente se puede usar para hacer coincidir la solicitud de suscripción WebSocket deseada con el ID de canal para esa suscripción.

Tenga en cuenta que si realiza varias suscripciones WebSocket al mismo tiempo, a todas se les asignará el mismo valor reqid. Para asignar un valor reqid diferente, cada fuente debe suscribirse individualmente.

Quiero más detalles, ¿dónde puedo encontrarlos?

La especificación completa de la API WebSocket está disponible en la documentación de la API WebSocket.

Diferencias entre los símbolos de pares de divisas en las API REST y WebSocket.

La API WebSocket solo acepta símbolos de pares de divisas en formato ISO 4217-A3, como XBT/USD.

El punto final AssetPairs de la API REST se puede usar para traducir símbolos entre las versiones de la API REST (como XBTUSD o XXBTZUSD) y la versión de la API WebSocket (como XBT/USD).

https://api.kraken.com/0/public/AssetPairs

El campo wsname proporciona el símbolo de la API WebSocket.

Cómo construir un libro de órdenes

La fuente del libro de la API WebSocket es la más compleja de todas las fuentes WebSocket, pero siempre que los mensajes de la fuente del libro se interpreten correctamente, es posible mantener una copia local de un libro de órdenes con solo unas pocas líneas de código.

Nuestras páginas de soporte de la API WebSocket proporcionan instrucciones detalladas para interpretar los mensajes de la fuente del libro, junto con una transcripción de ejemplo de la fuente del libro y código de ejemplo (en Python) para mantener una copia local válida de un libro de órdenes.

¿Cuáles son los límites de conexión de la API WebSocket?

La API WebSocket limita el número máximo de conexiones simultáneas para proporcionar protección contra el uso indebido (como ataques DDoS, por ejemplo). Si su cliente WebSocket realiza demasiadas conexiones al mismo tiempo, se recibirá el siguiente mensaje de error:

{“error”: {“message”: “You have reached maximum capacity for WebSocket connections. Please reach out to Kraken support team for any questions.“, “hint”: “Your code may be reconnecting too often or when it has no need to.“, “name”: “WebSocket connection rate error”}}

La API WebSocket permite múltiples suscripciones a fuentes a través de una única conexión WebSocket (como suscribirse a todos los datos de mercado disponibles para el par de divisas XBT/USD a través de una única conexión), por lo que es posible transmitir todos los datos de mercado disponibles para todos los pares de divisas sin alcanzar los límites de conexión de WebSocket.

¿Cuáles son los límites de velocidad de la API WebSocket?

Los mismos límites de velocidad de trading se aplican a todas las interfaces de entrada de órdenes (sitio web, Kraken Terminal, API REST y WebSocket), y se explican en detalle en nuestra página de soporte de límites de velocidad.

El límite de velocidad de mensajes de una única conexión de la API WebSocket variará según la carga del sistema. Los clientes de la API WebSocket recibirán el mensaje de error {"Error": "Exceeded msg rate"} cuando se exceda el límite de velocidad de mensajes.

Trading (realizar/cancelar órdenes) a través de la API WebSocket.

El trading a través de la API WebSocket está disponible a través de los puntos finales addOrder y cancelOrder, que se utilizan para realizar nuevas órdenes y cancelar órdenes existentes (abiertas) respectivamente.

Los puntos finales de trading de WebSocket están disponibles a través de la misma conexión WebSocket privada (wss://ws-auth.kraken.com/) que las fuentes de gestión de cuentas privadas (openOrders y ownTrades).

Los detalles completos sobre los puntos finales de trading están disponibles a través de la documentación de la API WebSocket, y nuestras páginas de soporte de la API WebSocket proporcionan más información y ejemplos para usar los puntos finales de trading en su propio código.

¿Por qué recibo un error 403 al conectarme a la API WebSocket?

Las conexiones de la API WebSocket se intermedian a través de Cloudflare, por lo que cualquier configuración de seguridad implementada por Cloudflare puede afectar las conexiones tanto a las URL públicas (wss://ws.kraken.com) como a las privadas (wss://ws-auth.kraken.com).

Cloudflare requiere que se utilice la Indicación de Nombre de Servidor (SNI) para todas las conexiones TLS; de lo contrario, la conexión WebSocket fallaría y se devolvería un error HTTP 403 Prohibido. Las páginas de soporte de Cloudflare proporcionan más detalles sobre su requisito de TLS SNI.

Nuestra biblioteca oficial de la API WebSocket de Python se ha actualizado para admitir TLS SNI, pero algunas bibliotecas de la API WebSocket de terceros aún podrían verse afectadas. Póngase en contacto con nuestro equipo de soporte de API si necesita ayuda para actualizar su código de la API WebSocket para admitir TLS SNI.

Asistencia con la API WebSocket.

Póngase en contacto con nuestro equipo de soporte de API si necesita ayuda para implementar su cliente de la API WebSocket.