WebSocket API v1 - Exemplo de feed de dados de mercado

Última atualização: 31/03/2025

Os feeds de dados de mercado da WebSocket API v1 são uma série de feeds públicos (não autenticados) que fornecem um fluxo em tempo real dos dados de negociação disponíveis (ticker, tempo e vendas, livro de ordens, etc.) para os nossos mercados.

Como fluxos de dados de mercado em tempo real, quaisquer alterações nos dados de mercado (como atualizações aos melhores preços de compra/venda ou volumes, por exemplo) fariam com que uma mensagem de atualização fosse enviada através de um ou mais dos feeds de dados de mercado.

Como subscrever um feed de dados de mercado

Uma vez estabelecida uma ligação à WebSocket API v1 (utilizando o URL público wss://ws.kraken.com/), os feeds de dados de mercado podem ser subscritos enviando uma mensagem de subscrição como a seguinte:

  • {"event":"subscribe", "subscription":{"name":"ticker"}, "pair":["BTC/USD"]}

Após a receção de um pedido de subscrição válido, os feeds de dados de mercado enviariam uma mensagem de confirmação de subscrição:

  • {"channelID":324,"channelName":"ticker","event":"subscriptionStatus","pair":"XBT/USD","status":"subscribed","subscription":{"name":"ticker"}}

seguido por um instantâneo inicial dos dados de mercado (dependendo do feed em questão) e, em seguida, o fluxo em tempo real dos dados de mercado.

Exemplo de fluxo em tempo real de um feed de dados de mercado

O seguinte é um exemplo do feed de ticker, ilustrando o tipo de mensagens que são recebidas para várias alterações de dados de mercado (como a ocorrência de uma negociação que causa a alteração do volume de melhor oferta/procura):

[324,{"a":["42243.20000",3,"3.04172624"],"b":["42243.10000",0,"0.28500000"],"c":["42243.20000","0.00073657"],"v":["634.15053067","2117.90194729"],"p":["41908.86644","41673.47236"],"t":[7214,21130],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41896.10000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42243.20000",0,"0.01460168"],"b":["42243.10000",3,"3.82293519"],"c":["42243.20000","0.01398000"],"v":["634.16451067","2117.88824812"],"p":["41908.87381","41673.47318"],"t":[7215,21126],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41898.80000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42255.00000",0,"0.08406816"],"b":["42243.10000",6,"6.33160603"],"c":["42255.00000","0.01593184"],"v":["634.19504419","2117.90471127"],"p":["41908.89020","41673.47996"],"t":[7217,21123],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41908.00000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42254.80000",0,"0.53200000"],"b":["42251.60000",0,"0.10000000"],"c":["42254.80000","0.05800000"],"v":["634.25304419","2117.94005439"],"p":["41908.92184","41673.49337"],"t":[7218,21122],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42248.60000",2,"2.84602281"],"b":["42247.00000",0,"0.12500000"],"c":["42248.60000","0.04168347"],"v":["634.29472766","2117.98132192"],"p":["41908.94416","41673.50464"],"t":[7219,21122],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
[324,{"a":["42248.60000",2,"2.83204281"],"b":["42246.90000",0,"0.10000000"],"c":["42248.60000","0.01398000"],"v":["634.30870766","2117.99530192"],"p":["41908.95164","41673.50844"],"t":[7220,21123],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}

Note que as mensagens heartbeat são enviadas com uma frequência de 1 por segundo quando não há ticker (ou outros dados de mercado) disponíveis.

Os detalhes dos campos/valores individuais nas mensagens JSON para o feed de ticker (e todos os outros feeds de dados de mercado) estão disponíveis na nossa documentação da WebSocket API v1.

Precisa de mais ajuda?