API Kraken Futures | WebSockets Public API

연결

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

 

소켓이 열리면 subscribe 요청 메시지를 보내 공개 채널을 구독할 수 있습니다.

 

 

Methods

Ticker

이 엔드포인트는 현재 상장된 모든 Futures 계약과 인덱스에 대한 현재 시장 데이터를 반환합니다. 인증이 필요하지 않습니다.

SubscribeTicker 메서드를 호출하여 ticker를 구독하십시오:


SubscribeTicker(['PI_XBTUSD']);

구독이 성공하면 OnKrakenFuturesSubscribed 이벤트가 호출됩니다:


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

UnSubscribeTicker 메서드를 호출하여 UnSubscribe합니다:


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;

Ticker 업데이트는 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

trade 피드는 체결된 거래에 대한 정보를 반환합니다

SubscribeTrade 메서드를 호출하여 Trade feed를 구독하십시오.

 
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

 

}

 

]

 

}

 

Book

이 피드는 주문서에 대한 정보를 반환합니다.

SubscribeBook 메서드를 호출하여 Book을 구독하십시오. 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;

Book 업데이트는 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 lite 피드는 상장된 상품에 대한 ticker 정보를 반환합니다.

SubscribeTickerLite 메서드를 호출하여 Spread 피드를 구독합니다.

   
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;

Spread 업데이트는 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();

 

 

 

Events

OnConnect: websocket 클라이언트가 서버에 연결될 때입니다.

OnKrakenFuturesConnect: websocket 연결이 성공한 후 그리고 서버가 시스템 상태를 보낼 때 호출됩니다.

OnKrakenFuturesSubscribed: 채널에 대한 구독이 성공한 후 호출됩니다.

OnKrakenFuturesUnSubscribed: 채널에서 성공적으로 구독 해제된 후 호출됩니다.

OnKrakenFuturesError: 구독/구독 취소 중에 오류가 있으면 호출됩니다.

OnKrakenData: 채널 구독에 업데이트가 있을 때마다 호출됩니다.