API WebSocket v1 - Exemplo de feed de dados de mercado

Última atualização: 31 de mar. de 2025

Os feeds de dados de mercado da API WebSocket 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 nossos mercados.

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

Como subscrever um feed de dados de mercado

Uma vez estabelecida uma conexão com a API WebSocket v1 (usando 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 o recebimento de uma solicitação de subscrição válida, 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 snapshot inicial dos dados de mercado (dependendo do feed em questão) e, em seguida, o fluxo ao vivo dos dados de mercado em tempo real.

Exemplo de fluxo ao vivo de um feed de dados de mercado

A seguir, um exemplo do feed ticker, ilustrando o tipo de mensagens recebidas para várias alterações nos dados de mercado (como a ocorrência de uma negociação que causa a alteração do melhor volume de compra/venda):

[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"}

Observe 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 ticker (e todos os outros feeds de dados de mercado) estão disponíveis em nossa documentação da API WebSocket v1.

Precisa de mais ajuda?