WebSocket API v1 - Contoh suapan data pasaran

Terakhir dikemas kini: 31 Mac 2025

Suapan data pasaran WebSocket API v1 ialah siri suapan awam (tidak disahkan) yang menyediakan strim data dagangan masa nyata yang tersedia (ticker, masa dan jualan, buku pesanan, dsb.) untuk pasaran kami.

Sebagai strim data pasaran langsung, sebarang perubahan pada data pasaran (seperti kemas kini kepada harga atau volum bida/tanya terbaik, contohnya) akan menyebabkan mesej kemas kini dihantar melalui satu atau lebih suapan data pasaran.

Cara melanggan suapan data pasaran

Setelah sambungan ke WebSocket API v1 telah diwujudkan (menggunakan URL awam wss://ws.kraken.com/), suapan data pasaran boleh dilanggan dengan menghantar mesej langganan seperti berikut:

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

Setelah menerima permintaan langganan yang sah, suapan data pasaran akan menghantar mesej pengesahan langganan:

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

diikuti oleh tangkapan data pasaran awal (bergantung pada suapan yang berkenaan), dan kemudian strim langsung data pasaran masa nyata.

Contoh strim langsung daripada suapan data pasaran

Berikut ialah contoh suapan ticker, yang menggambarkan jenis mesej yang diterima untuk pelbagai perubahan data pasaran (seperti dagangan yang berlaku menyebabkan volum bida/tanya terbaik berubah):

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

Ambil perhatian bahawa mesej heartbeat dihantar pada kekerapan 1 sesaat apabila tiada ticker (atau data pasaran lain) tersedia.

Butiran medan/nilai individu dalam mesej JSON untuk suapan ticker (dan semua suapan data pasaran lain) tersedia dalam dokumentasi WebSocket API v1 kami.

Perlu bantuan lebih lanjut?