API Kraken Futures | WebSockets 公共 API

连接

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

 

套接字打开后，您可以通过发送订阅请求消息来订阅公共频道。

 

 

方法

行情

此端点返回所有当前上市 Futures 合约和指数的当前市场数据。不需要身份验证。

调用 SubscribeTicker 方法订阅行情：

SubscribeTicker(['PI_XBTUSD']);

如果订阅成功，将调用 OnKrakenFuturesSubscribed 事件：

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

通过调用 UnSubscribeTicker 方法取消订阅：

UnSubscribeTicker(['PI_XBTUSD']);

如果取消订阅成功，将调用 OnKrakenFuturesUnSubscribed 事件：

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

如果订阅/取消订阅时出错，将调用 OnKrakenFuturesError 事件。

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

行情更新将通过 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"

 

}

 

 

交易

交易数据流返回已成交交易的信息

调用 SubscribeTrade 方法订阅交易数据流。

 
SubscribeTrade(['PI_XBTUSD']);

如果订阅成功，将调用 OnKrakenFuturesSubscribed 事件：

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

通过调用 UnSubscribeTrade 方法取消订阅：

 
UnSubscribeTrade(['PI_XBTUSD']);

如果取消订阅成功，将调用 OnKrakenFuturesUnSubscribed 事件：

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

如果订阅/取消订阅时出错，将调用 OnKrakenFuturesError 事件。

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

交易更新将在 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

 

}

 

]

 

}

 

订单簿

此 feed 返回有关订单簿的信息。

调用 SubscribeBook 方法订阅订单簿，须传入 Symbol。

  
SubscribeBook(['PI_XBTUSD']);

如果订阅成功，将调用 OnKrakenFuturesSubscribed 事件：

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

调用 UnSubscribeBook 方法取消订阅：

    
UnSubscribeBook(['PI_XBTUSD']);

如果取消订阅成功，将调用 OnKrakenFuturesUnSubscribed 事件：

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

如果订阅/取消订阅时出错，将调用 OnKrakenFuturesError 事件。

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

订单簿更新将通过 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

Ticker 精简订阅源返回已上市产品的 Ticker 信息。

调用 SubscribeTickerLite 方法订阅价差数据流。

   
SubscribeTickerLite(['PI_XBTUSD']);

如果订阅成功，将调用 OnKrakenFuturesSubscribed 事件：

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

调用 UnSubscribeTickerLite 方法取消订阅：

    
UnSubscribeTickerLite(['PI_XBTUSD']);

如果取消订阅成功，将调用 OnKrakenFuturesUnSubscribed 事件：

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

如果订阅/取消订阅时出错，将调用 OnKrakenFuturesError 事件。

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

价差更新将在 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

心跳源按定时间隔发布心跳消息。

  
SubscribeHeartBeat();
 
UnSubscribeHeartBeat();

 

 

 

事件

OnConnect：当 WebSocket 客户端连接到服务器时。

OnKrakenFuturesConnect：在 WebSocket 成功连接后以及服务器发送系统状态时调用。

OnKrakenFuturesSubscribed： 成功订阅频道后调用。

OnKrakenFuturesUnSubscribed：成功取消订阅某个频道后调用。

OnKrakenFuturesError：订阅/取消订阅时发生任何错误时调用。

OnKrakenData：每次频道订阅有更新时调用。