API Kraken Futures | WebSockets Public API

Conexão

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

 

Assim que o socket estiver aberto, você pode assinar um canal público enviando uma mensagem de requisição de assinatura.

 

 

Métodos

Ticker

Este endpoint retorna dados de mercado atuais para todos os contratos e índices de Futures atualmente listados. Autenticação não é necessária.

Faça subscribe a um ticker chamando o método SubscribeTicker:


SubscribeTicker(['PI_XBTUSD']);

Se a assinatura for bem-sucedida, o evento OnKrakenFuturesSubscribed será chamado:


procedure OnKrakenFuturesSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#subscribed: ' + Feed + ' ' + ProductId);
end;

Cancele a assinatura chamando o método UnSubscribeTicker:


UnSubscribeTicker(['PI_XBTUSD']);

Se o cancelamento da assinatura for bem-sucedido, o evento OnKrakenFuturesUnSubscribed será chamado:


procedure OnKrakenFuturesUnSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#unsubscribed: ' + Feed + ' ' + ProductId);
end;

Se houver um erro ao tentar fazer subscribe / unsubscribe, o evento OnKrakenFuturesError será chamado.


procedure OnKrakenFuturesError(Sender: TObject; Error: string);
begin
  DoLog('#error: ' + Error);
end;

As atualizações de ticker serão notificadas no evento OnKrakenData.

{    "result":"success",

 

"tickers":[

 

{

 

"tag": "perpetual",

 

"pair": "XBT:USD",

 

"symbol": "pi_xbtusd",

 

"markPrice": 9520.2,

 

"bid": 9520,

 

"bidSize": 30950,

 

"ask": 9520.5,

 

"askSize": 3779,

 

"vol24h": 68238712,

 

"openInterest": 29308193,

 

"open24h": 10137,

 

"last": 9521,

 

"lastTime": "2020-06-03T08:14:26.624Z",

 

"lastSize": 1,

 

"suspended": false,

 

"fundingRate": 4.943012455e-9,

 

"fundingRatePrediction": 4.414499215e-9

 

}

 

{

 

"tag": "quarter",

 

"pair": "XBT:USD",

 

"symbol": "fi_xbtusd_200925",

 

"markPrice": 9659.8,

 

"bid": 9659.5,

 

"bidSize": 6480,

 

"ask": 9660,

 

"askSize": 17100,

 

"vol24h": 4562580,

 

"openInterest": 3573325,

 

"open24h": 10370.5,

 

"last": 9660,

 

"lastTime": "2020-06-03T08:10:37.800Z",

 

"lastSize": 5000,

 

"suspended": false

 

},

 

{

 

"symbol": "in_xbtusd",

 

"last": 9519,

 

"lastTime": "2020-06-03T08:14:49.000Z"

 

}

 

],

 

"serverTime": "2020-06-03T08:14:49.865Z"

 

}

 

 

Trade

O feed de trade retorna informações sobre negociações executadas

Assine o feed Trade chamando o método SubscribeTrade.

 
SubscribeTrade(['PI_XBTUSD']);

Se a assinatura for bem-sucedida, o evento OnKrakenFuturesSubscribed será chamado:

 
procedure OnKrakenFuturesSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#subscribed: ' + Feed + ' ' + ProductId);
end;

Cancele a assinatura chamando o método UnSubscribeTrade:

 
UnSubscribeTrade(['PI_XBTUSD']);

Se o cancelamento da assinatura for bem-sucedido, o evento OnKrakenFuturesUnSubscribed será chamado:

  
procedure OnrakenFuturesUnSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#unsubscribed: ' + Feed + ' ' + ProductId);
end;

Se houver um erro ao tentar fazer subscribe / unsubscribe, o evento OnKrakenFuturesError será chamado.

   
procedure OnKrakenFuturesSubscriptionError(Sender: TObject; Error: string);
begin
  DoLog('#error: ' + Error);
end;

As atualizações de trade serão notificadas no evento OnKrakenData.

{  "feed": "trade_snapshot",

 

"product_id": "PI_XBTUSD",

 

  "trades": [

 

{

 

"feed": "trade",

 

"product_id": "PI_XBTUSD",

 

"uid": "caa9c653-420b-4c24-a9f1-462a054d86f1",

 

"side": "sell",

 

"type": "fill",

 

"seq": 655508,

 

"time": 1612269657781,

 

   "qty": 440,

 

"price": 34893

 

},

 

{

 

"feed": "trade",

 

"product_id": "PI_XBTUSD",

 

"uid": "45ee9737-1877-4682-bc68-e4ef818ef88a",

 

"side": "sell",

 

"type": "fill",

 

"seq": 655507,

 

"time": 1612269656839,

 

"qty": 9643,

 

"price": 34891

 

}

 

]

 

}

 

Book

Este feed retorna informações sobre o livro de ordens.

Inscreva-se em um Book chamando o método SubscribeBook; você deve passar o Symbol.

  
SubscribeBook(['PI_XBTUSD']);

Se a assinatura for bem-sucedida, o evento OnKrakenFuturesSubscribed será chamado:

   
procedure OnKrakenFuturesSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#subscribed: ' + Feed + ' ' + ProductId);
end;

Cancele a assinatura chamando o método UnSubscribeBook:

    
UnSubscribeBook(['PI_XBTUSD']);

Se o cancelamento da assinatura for bem-sucedido, o evento OnKrakenFuturesUnSubscribed será chamado:

  
procedure OnKrakenFuturesUnSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#unsubscribed: ' + Feed + ' ' + ProductId);
end;

Se houver um erro ao tentar fazer subscribe / unsubscribe, o evento OnKrakenFuturesError será chamado.

   
procedure OnKrakenFuturesError(Sender: TObject; Error: string);
begin
  DoLog('#error: ' + Error);
end;

As atualizações de book serão notificadas no evento OnKrakenData.

{

 

"feed": "book_snapshot",

 

"product_id": "PI_XBTUSD",

 

"timestamp": 1612269825817,

 

"seq": 326072249,

 

"tickSize": null,

 

"bids": [{

 

"price": 34892.5,

 

"qty": 6385

 

},

 

{

 

"price": 34892,

 

"qty": 10924

 

}

 

],

 

"asks": [{

 

"price": 34911.5,

 

"qty": 20598

 

},

 

{

 

"price": 34912,

 

"qty": 2300

 

}

 

]

 

}

 

Ticker Lite

O feed ticker lite retorna informações de ticker sobre os produtos listados.

Assine o feed Spread chamando o método SubscribeTickerLite.

   
SubscribeTickerLite(['PI_XBTUSD']);

Se a assinatura for bem-sucedida, o evento OnKrakenFuturesSubscribed será chamado:

   
procedure OnKrakenFuturesSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#subscribed: ' + Feed + ' ' + ProductId);
end;

Cancele a assinatura chamando o método UnSubscribeTickerLite:

    
UnSubscribeTickerLite(['PI_XBTUSD']);

Se o cancelamento da assinatura for bem-sucedido, o evento OnKrakenFuturesUnSubscribed será chamado:

   
procedure OnKrakenFuturesUnSubscribed(Sender: TObject; Feed, ProductId: string);
begin
  DoLog('#unsubscribed: ' + Feed + ' ' + ProductId);
end;

Se houver um erro ao tentar fazer subscribe / unsubscribe, o evento OnKrakenFuturesError será chamado.

  
procedure OnKrakenFuturesError(Sender: TObject; Error: string);
begin
  DoLog('#error: ' + Error);
end;

As atualizações de spread serão notificadas no evento OnKrakenData.

{  "feed": "ticker_lite",

 

"product_id": "PI_XBTUSD",

 

  "bid": 34932,

 

"ask": 34949.5,

 

"change": 3.3705205220015966,

 

  "premium": 0.1,

 

"volume": 264126741,

 

"tag": "perpetual",

 

"pair": "XBT:USD",

 

  "dtm": 0,

 

"maturityTime": 0

 

}

 

{

 

"feed":"ticker_lite",

 

"product_id":"FI_ETHUSD_210625",

 

"bid":1753.45,

 

"ask":1760.35,

 

"change":13.448175559936647,

 

"premium":9.1,

 

"volume":6899673.0,

 

"tag":"semiannual",

 

"pair":"ETH:USD",

 

"dtm":141,

 

"maturityTime":1624633200000

 

}

 

HeartBeat

O feed de heartbeat publica uma mensagem de heartbeat em intervalos cronometrados.

  
SubscribeHeartBeat();
 
UnSubscribeHeartBeat();

 

 

 

Eventos

OnConnect: quando o cliente websocket está conectado ao servidor.

OnKrakenFuturesConnect: chamado após uma conexão websocket bem-sucedida e quando o servidor envia o status do sistema.

OnKrakenFuturesSubscribed: chamado após uma assinatura bem-sucedida em um canal.

OnKrakenFuturesUnSubscribed: chamado após uma desinscrição bem-sucedida de um canal.

OnKrakenFuturesError: chamado se houver algum erro durante a inscrição/cancelamento de inscrição.

OnKrakenData: chamado toda vez que uma assinatura de canal recebe uma atualização.