WebSocket API v1 - Ví dụ về nguồn cấp dữ liệu thị trường

Cập nhật lần cuối: 31 thg 3, 2025

Các nguồn cấp dữ liệu thị trường WebSocket API v1 là một loạt các nguồn cấp dữ liệu công khai (không được xác thực), cung cấp luồng dữ liệu giao dịch có sẵn theo thời gian thực (ticker, thời gian và doanh số, sổ lệnh, v.v.) cho các thị trường của chúng tôi.

Là các luồng dữ liệu thị trường trực tiếp, mọi thay đổi đối với dữ liệu thị trường (chẳng hạn như cập nhật giá mua/bán tốt nhất hoặc khối lượng) sẽ khiến một thông báo cập nhật được gửi qua một hoặc nhiều nguồn cấp dữ liệu thị trường.

Cách đăng ký nguồn cấp dữ liệu thị trường

Sau khi kết nối với WebSocket API v1 đã được thiết lập (sử dụng URL công khai wss://ws.kraken.com/), các nguồn cấp dữ liệu thị trường có thể được đăng ký bằng cách gửi một thông báo đăng ký như sau:

  • •

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

Khi nhận được yêu cầu đăng ký hợp lệ, các nguồn cấp dữ liệu thị trường sẽ gửi một thông báo xác nhận đăng ký:

  • •

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

tiếp theo là một ảnh chụp nhanh dữ liệu thị trường ban đầu (tùy thuộc vào nguồn cấp dữ liệu được đề cập), và sau đó là luồng dữ liệu thị trường theo thời gian thực.

Ví dụ về luồng trực tiếp từ nguồn cấp dữ liệu thị trường

Sau đây là một ví dụ về nguồn cấp dữ liệu ticker, minh họa loại thông báo được nhận cho các thay đổi dữ liệu thị trường khác nhau (chẳng hạn như giao dịch xảy ra làm thay đổi khối lượng mua/bán tốt nhất):

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

Lưu ý rằng các thông báo heartbeat được gửi với tần suất 1 lần mỗi giây khi không có ticker (hoặc dữ liệu thị trường khác) nào khả dụng.

Chi tiết về các trường/giá trị riêng lẻ trong các thông báo JSON cho nguồn cấp dữ liệu ticker (và tất cả các nguồn cấp dữ liệu thị trường khác) có sẵn trong tài liệu WebSocket API v1 của chúng tôi.

Bạn cần thêm trợ giúp?