Nguồn cấp dữ liệu riêng tư WebSocket API v1 - ownTrades

Cập nhật lần cuối: 1 thg 4, 2025

Nguồn cấp dữ liệu WebSocket API v1 ownTrades là một nguồn cấp dữ liệu quản lý tài khoản riêng tư, cung cấp thông báo theo thời gian thực về tất cả các giao dịch được thực hiện bởi tài khoản Kraken của bạn.

Mọi giao dịch phát sinh do một trong các lệnh của bạn sẽ khiến một tin nhắn mới được gửi qua nguồn cấp dữ liệu ownTrades.

Cách đăng ký

Sau khi kết nối với WebSocket API v1 đã được thiết lập, bạn có thể đăng ký nguồn cấp dữ liệu ownTrades bằng cách truy xuất mã thông báo xác thực thông qua điểm cuối GetWebSocketsToken của REST API, sau đó gửi một tin nhắn đăng ký như sau:

  • {"event":"subscribe", "subscription":{"name":"ownTrades", "token":"WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f"}}

Ví dụ về nguồn cấp dữ liệu

Sau đây là một ví dụ về nguồn cấp dữ liệu ownTrades:

{"connectionID":12678739536485265125,"event":"systemStatus","status":"online","version":"0.3.0"}{"channelName":"ownTrades","event":"subscriptionStatus","status":"subscribed","subscription":{"name":"ownTrades"}}[[{"T7YS4M-6HGBO-GDAGOY":{"cost":"70.19110","fee":"0.18250","margin":"0.00000","ordertxid":"OPJVQI-PXMPK-4WT5WP","ordertype":"market","pair":"XBT/USD","postxid":"TKH2SE-M7IF5-CFI7LT","price":"8092.20053","time":"1570270020.122169","type":"buy","vol":"0.00867392"}},{"TNN4V7-BTS6X-O3CQF3":{"cost":"54.00046","fee":"0.14040","margin":"0.00000","ordertxid":"OKIRSX-DUS37-W33QZN","ordertype":"market","pair":"XBT/USD","postxid":"TKH2SE-M7IF5-CFI7LT","price":"8090.59895","time":"1570269988.387027","type":"sell","vol":"0.00667447"}}], "ownTrades"]{"event":"heartbeat"}{"event":"heartbeat"}[[{"T7GUL2-5N7YZ-QVQDCJ":{"cost":"0.35002","fee":"0.00098","margin":"0.07000","ordertxid":"OMBOUS-KM52J-NGDZH6","ordertype":"market","pair":"ETH/USD","posstatus":"Opened","postxid":"TKH2SE-M7IF5-CFI7LT","price":"175.01000","time":"1570447638.474936","type":"buy","vol":"0.00200000"}}],"ownTrades"]{"event":"heartbeat"}{"event":"heartbeat"}[[{"TEY4EI-7WY6F-YJRXQF":{"cost":"0.35000","fee":"0.00091","margin":"0.00000","ordertxid":"OVNJYW-XAEHY-IUN4EH","ordertype":"market","pair":"ETH/USD","posstatus":"Closing","postxid":"T6KC22-6XWFG-ZWYYTG","price":"175.00000","time":"1570447652.939563","type":"sell","vol":"0.00200000"}}],"ownTrades"]{"event":"heartbeat"}{"event":"heartbeat"}

Khi đăng ký nguồn cấp dữ liệu ownTrades, một tin nhắn trạng thái đăng ký sẽ được nhận:

  • {"channelName":"ownTrades","event":"subscriptionStatus","status":"subscribed","subscription":{"name":"ownTrades"}}

tiếp theo là một ảnh chụp nhanh với thông tin chi tiết về bất kỳ giao dịch nào được thực hiện gần đây cho tài khoản:

  • [[{"T7YS4M-6HGBO-GDAGOY":{"cost":"70.19110","fee":"0.18250","margin":"0.00000","ordertxid":"OPJVQI-PXMPK-4WT5WP","ordertype":"market","pair":"XBT/USD","postxid":"TKH2SE-M7IF5-CFI7LT","price":"8092.20053","time":"1570270020.122169","type":"buy","vol":"0.00867392"}},{"TNN4V7-BTS6X-O3CQF3":{"cost":"54.00046","fee":"0.14040","margin":"0.00000","ordertxid":"OKIRSX-DUS37-W33QZN","ordertype":"market","pair":"XBT/USD","postxid":"TKH2SE-M7IF5-CFI7LT","price":"8090.59895","time":"1570269988.387027","type":"sell","vol":"0.00667447"}}], "ownTrades"]

Khi bất kỳ giao dịch mới nào được thực hiện, các tin nhắn sẽ được nhận cung cấp thông tin chi tiết về các giao dịch đó. Các tin nhắn sau đây cho biết hai giao dịch riêng biệt, ban đầu đã mở một vị thế ETH dài trên ETHUSD, và ngay sau đó đã đóng vị thế:

  • [[{"T7GUL2-5N7YZ-QVQDCJ":{"cost":"0.35002","fee":"0.00098","margin":"0.07000","ordertxid":"OMBOUS-KM52J-NGDZH6","ordertype":"market","pair":"ETH/USD","posstatus":"Opened","postxid":"TKH2SE-M7IF5-CFI7LT","price":"175.01000","time":"1570447638.474936","type":"buy","vol":"0.00200000"}}],"ownTrades"]

  • [[{"TEY4EI-7WY6F-YJRXQF":{"cost":"0.35000","fee":"0.00091","margin":"0.00000","ordertxid":"OVNJYW-XAEHY-IUN4EH","ordertype":"market","pair":"ETH/USD","posstatus":"Closing","postxid":"T6KC22-6XWFG-ZWYYTG","price":"175.00000","time":"1570447652.939563","type":"sell","vol":"0.00200000"}}],"ownTrades"]

Dấu phân cách thập phân và hàng nghìn hiển thị trong bài viết này có thể khác với các định dạng hiển thị trên nền tảng giao dịch của chúng tôi. Xem lại bài viết của chúng tôi về cách chúng tôi sử dụng dấu chấm và dấu phẩy để biết thêm thông tin.

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