URL: wss://ws-auth.kraken.com (v1) ou wss://ws-auth.kraken.com/v2 (v2, recomendado)
O componente agora suporta a WebSocket API v2 por meio da propriedade Version (padrão: 2).
Uma vez que o socket esteja aberto, você pode se inscrever em canais de dados privados enviando uma mensagem de requisição de subscribe autenticada.
O cliente da API deve solicitar um "token" de autenticação por meio do seguinte endpoint da REST API "GetWebSocketsToken" para conectar-se aos endpoints Private de WebSockets. O token deve ser utilizado dentro de 15 minutos após sua criação. O token não expira uma vez que uma conexão a uma mensagem private da API de WebSockets (openOrders ou ownTrades) seja mantida.
Para obter um Token Websockets, uma API Key e um API Secret devem ser definidos no componente Kraken Options, a api key fornecida pela Kraken em sua conta
Kraken.ApiKey := 'api key';
Kraken.ApiSecret := 'api secret';Obtenha uma lista dos seus próprios trades; na primeira assinatura, você obtém uma lista dos últimos 50 trades
SubscribeOwnTrades();Mais tarde, você pode cancelar a assinatura de OwnTrades chamando o método UnSubscribeOwnTrades.
UnSubscribeOwnTrades();Exemplo de resposta do servidor
[
[
{
"TDLH43-DVQXD-2KHVYY": {
"cost": "1000000.00000",
"fee": "600.00000",
"margin": "0.00000",
"ordertxid": "TDLH43-DVQXD-2KHVYY",
"ordertype": "limit",
"pair": "XBT/EUR",
"postxid": "OGTT3Y-C6I3P-XRI6HX",
"price": "100000.00000",
"time": "1560520332.914664",
"type": "buy",
"vol": "1000000000.00000000"
}
}
],
"ownTrades"
]Feed para mostrar todas as ordens em aberto pertencentes à chave de API do usuário autenticado. O snapshot inicial fornecerá a lista de todas as ordens em aberto e, em seguida, quaisquer atualizações à lista de ordens em aberto serão enviadas. Para atualizações de mudança de status, como 'closed', os campos orderid e status estarão presentes no payload
SubscribeOpenOrders();Posteriormente, você pode cancelar a assinatura de OpenOrders, chamando o método UnSubscribeOpenOrders .
UnSubscribeOpenOrders();Exemplo de resposta do servidor
[
[
{
"OGTT3Y-C6I3P-XRI6HX": {
"cost": "0.00000",
"descr": {
"close": "",
"leverage": "0:1",
"order": "sell 0.00001000 XBT/EUR @ limit 9.00000 with 0:1 leverage",
"ordertype": "limit",
"pair": "XBT/EUR",
"price": "9.00000",
"price2": "0.00000",
"type": "sell"
},
"expiretm": "0.000000",
"fee": "0.00000",
"limitprice": "9.00000",
"misc": "",
"oflags": "fcib",
"opentm": "0.000000",
"price": "9.00000",
"refid": "OKIVMP-5GVZN-Z2D2UA",
"starttm": "0.000000",
"status": "open",
"stopprice": "0.000000",
"userref": 0,
"vol": "0.00001000",
"vol_exec": "0.00000000"
}
}
],
"openOrders"
]Envia uma nova ordem à Kraken
oKrakenOrder := TsgcWSKrakenOrder.Create;
oKrakenOrder.Pair := 'XBT/USD';
oKrakenOrder._Type := kosBuy;
oKrakenOrder.OrderType := kotMarket;
oKrakenOrder.Volume := 1;
AddOrder(oKrakenOrder);Lista de parâmetros da Ordem
pair = asset pair
type = type of order (buy/sell)
ordertype = order type:
market
limit (price = limit price)
stop-loss (price = stop loss price)
take-profit (price = take profit price)
stop-loss-profit (price = stop loss price, price2 = take profit price)
stop-loss-profit-limit (price = stop loss price, price2 = take profit price)
stop-loss-limit (price = stop loss trigger price, price2 = triggered limit price)
take-profit-limit (price = take profit trigger price, price2 = triggered limit price)
trailing-stop (price = trailing stop offset)
trailing-stop-limit (price = trailing stop offset, price2 = triggered limit offset)
stop-loss-and-limit (price = stop loss price, price2 = limit price)
settle-position
price = price (optional. dependent upon ordertype)
price2 = secondary price (optional. dependent upon ordertype)
volume = order volume in lots
leverage = amount of leverage desired (optional. default = none)
oflags = comma delimited list of order flags (optional):
viqc = volume in quote currency (not available for leveraged orders)
fcib = prefer fee in base currency
fciq = prefer fee in quote currency
nompp = no market price protection
post = post only order (available when ordertype = limit)
starttm = scheduled start time (optional):
0 = now (default)
+<n> = schedule start time <n> seconds from now
<n> = unix timestamp of start time
expiretm = expiration time (optional):
0 = no expiration (default)
+<n> = expire <n> seconds from now
<n> = unix timestamp of expiration time
userref = user reference id. 32-bit signed number. (optional)
validate = validate inputs only. do not submit order (optional)
optional closing order to add to system when order gets filled:
close[ordertype] = order type
close[price] = price
close[price2] = secondary priceExemplo de resposta do servidor
{
"descr": "buy 0.01770000 XBTUSD @ limit 4000",
"event": "addOrderStatus",
"status": "ok",
"txid": "ONPNXH-KMKMU-F4MR5V"
}Cancelar ordem
CancelOrder('Order Id');Exemplo de resposta do servidor
{
"event": "cancelOrderStatus",
"status": "ok"
}