API Kraken Futures | WebSockets Private API

Conexión

URL: wss://futures.kraken.com/ws/v1

 

Autenticación

Las solicitudes de suscripción y cancelación de suscripción a feeds privados de WebSocket requieren un mensaje de desafío firmado con el api_secret del usuario.

El desafío se obtiene tal como se muestra en la sección WebSocket API Public (usando la api_key).

Las solicitudes autenticadas deben incluir tanto el mensaje de desafío original (original_challenge) como el firmado (signed_challenge) en formato JSON.

Para obtener un Websockets Challenge, debe configurar una clave API y un secreto API en el componente Kraken Options; la clave API la proporciona Kraken en su cuenta.

  
Kraken.ApiKey := 'api key';
Kraken.ApiSecret := 'api secret';

Métodos

Órdenes Abiertas Detalladas

Este canal de suscripción publica información sobre las órdenes abiertas del usuario. Este canal añade información adicional sobre todas las órdenes post-only que no pudieron cruzar el libro.

  
SubscribeOpenOrdersVerbose();

Posteriormente, puede cancelar la suscripción de OpenOrdersVerbose llamando al método UnSubscribeOpenOrdersVerbose

  
UnSubscribeOpenOrdersVerbose();

Ejemplo de respuesta del servidor

{        'feed':'open_orders_verbose_snapshot',   'account':'0f9c23b8-63e2-40e4-9592-6d5aa57c12ba',   'orders':[ 
        {           'instrument':'PI_XBTUSD',         'time':1567428848005,         'last_update_time':1567428848005,         'qty':100.0,         'filled':0.0,         'limit_price':8500.0,         'stop_price':0.0,         'type':'limit',         'order_id':'566942c8-a3b5-4184-a451-622b09493129',         'direction':0,         'reduce_only':False      }   ]}

Posiciones abiertas

Este feed de suscripción publica las posiciones abiertas de la cuenta del usuario.

  
SubscribeOpenPositions();

Posteriormente, puede cancelar la suscripción a OpenPositions llamando al método UnSubscribeOpenPositions

  
UnSubscribeOpenPositions();

Ejemplo de respuesta del servidor

{
    "feed": "open_positions",
    "account": "DemoUser",
    "positions": [{
        "instrument": "fi_xbtusd_180316",
        "balance": 2000.0,
        "entry_price": 11675.86541981,
        "mark_price": 11090.0,
        "index_price": 12290.550000000001,
        "pnl": -0.00905299
    }]
}

Registro de cuenta

Esta fuente de suscripción publica información de la cuenta.

  
SubscribeAccountLog();

Posteriormente, puede cancelar la suscripción de AccountLog llamando al método UnSubscribeAccountLog

  
UnSubscribeAccountLog();

Ejemplo de respuesta del servidor

{
    'feed': 'account_log_snapshot',
    'logs': [{
                'id': 1690,
                'date': '2019-07-11T08:00:00.000Z',
                'asset': 'bch',
                'info': 'funding 
                rate change ','
                booking_uid ':'
                86 fdc252 - 1 b6e - 40 ec - ac1d - c7bd46ddeebf ','
                margin_account ':'
                f - bch: usd ','
                old_balance ':0.01215667051,'
                new_balance ':0.01215736653,'
                old_average_entry_price ':0.0,'
                new_average_entry_price ':0.0,'
                trade_price ':0.0,'
                mark_price ':0.0,'
                realized_pnl ':0.0,'
                fee ':0.0,'
                execution ':'
                ','
                collateral ':'
                bch ','
                funding_rate ':-8.7002552653e-08,'
                realized_funding ':6.9602e-07}]
}

Rellenos

Esta suscripción publica información sobre ejecuciones de órdenes.

  
SubscribeFills();

Posteriormente, puede cancelar la suscripción a Fills llamando al método UnSubscribeFills.

  
UnSubscribeFills();

Ejemplo de respuesta del servidor

{

 

"feed":"fills_snapshot",

 

"account":"DemoUser",

 

"fills":[

 

{

 

"instrument":"FI_XBTUSD_200925",

 

"time":1600256910739,

 

"price":10937.5,

 

"seq":36,

 

"buy":true,

 

"qty":5000.0,

 

"order_id":"9e30258b-5a98-4002-968a-5b0e149bcfbf",

 

"fill_id":"cad76f07-814e-4dc6-8478-7867407b6bff",

 

"fill_type":"maker",

 

"fee_paid":-0.00009142857,

 

"fee_currency":"BTC"

 

}]

 

}

 

Órdenes Abiertas

Este feed de suscripción publica información sobre las órdenes abiertas del usuario.

  
SubscribeOpenOrders();

Posteriormente, puede cancelar la suscripción a OpenOrders llamando al método UnSubscribeOpenOrders

  
UnSubscribeOpenOrders();

Ejemplo de respuesta del servidor

{

 

"feed": "open_orders_snapshot",

 

"account": "e258dba9-4dd4-4da5-bfef-75beb91c098e",

 

"orders": [

 

{

 

"instrument": "PI_XBTUSD",

 

"time": 1612275024153,

 

"last_update_time": 1612275024153,

 

"qty": 1000,

 

"filled": 0,

 

"limit_price": 34900,

 

"stop_price": 13789,

 

"type": "stop",

 

"order_id": "723ba95f-13b7-418b-8fcf-ab7ba6620555",

 

"direction": 1,

 

"reduce_only": false,

 

"triggerSignal": "last"

 

}

 

]

 

}

 

Saldo de Cuenta y Márgenes

Esta fuente de suscripción devuelve información sobre el saldo y el margen de la cuenta del cliente.

  
SubscribeAccountBalanceAndMargins();

Posteriormente, puede cancelar la suscripción a AccounBalance llamando al método UnSubscribeAccountBalanceAndMargins

  
UnSubscribeAccountBalanceAndMargins();

Ejemplo de respuesta del servidor

{

 

"feed": "account_balances_and_margins",

 

"account": "DemoUser",

 

"margin_accounts": [

 

{

 

"name": "xbt",

 

"balance": 0,

 

"pnl": 0,

 

"funding": 0,

 

"pv": 0,

 

"am": 0,

 

"im": 0,

 

"mm": 0

 

},

 

{

 

"name": "f-xbt:usd",

 

"balance": 9.99730211055,

 

"pnl": -0.00006034858674327812,

 

"funding": 0,

 

"pv": 9.997241761963258,

 

"am": 9.99666885201038,

 

"im": 0.0005729099528781564,

 

"mm": 0.0002864549764390782

 

},

 

],

 

"seq": 14

 

}

 

Notificaciones

Este feed de suscripción publica notificaciones al cliente.

  
SubscribeNotifications();

Más tarde, puede cancelar la suscripción a las notificaciones llamando al método UnSubscribeNotifications

  
UnSubscribeNotifications();

Ejemplo de respuesta del servidor

{  

 

"feed":"notifications_auth",

 

"notifications":[

 

{

 

"id":5,

 

"type":"market",

 

"priority":"low",

 

"note":"Una nota que describe la notificación.",

 

"effective_time":1520288300000

 

},

 

      ...

 

]

 

}