Kraken WebSocket API - คำถามที่พบบ่อย

Kraken มี WebSocket API หรือไม่? ฉันจะเชื่อมต่อได้อย่างไร?

Kraken มีทั้ง REST API และ WebSocket API โดย WebSocket API ของเรามีให้บริการที่ URL ที่ปลอดภัยดังต่อไปนี้:

ฟีดข้อมูลตลาดสาธารณะ (ไม่จำเป็นต้องยืนยันตัวตน): wss://ws.kraken.com/

ฟีดข้อมูลบัญชีส่วนตัว (ต้องยืนยันตัวตน) และปลายทางการซื้อขาย: wss://ws-auth.kraken.com/

ไม่จำเป็นต้องมีการยืนยันตัวตนเพื่อเชื่อมต่อกับฟีดข้อมูลตลาดสาธารณะ แต่จำเป็นต้องมีโทเค็นการยืนยันตัวตนที่ถูกต้องสำหรับฟีดส่วนตัว

ข้อความทั้งหมดที่ส่งและรับผ่าน WebSocket API จะถูกเข้ารหัสเป็นข้อความธรรมดาในรูปแบบ JSON รายละเอียดของแต่ละประเภทข้อความมีอยู่ในเอกสารประกอบ WebSocket API ของเรา

คุณมีไลบรารี WebSocket ให้บริการหรือไม่?

เรามีตัวอย่างโค้ด WebSocket API ที่หลากหลาย ซึ่งสามารถนำไปใช้ได้โดยตรง หรือใช้เป็นจุดเริ่มต้นสำหรับการนำไปใช้งานของคุณเอง:

WebSocket API ของเราสามารถนำไปใช้ได้ในภาษาโปรแกรมใดก็ได้ที่คุณต้องการ และทีมสนับสนุน API ของเรายินดีที่จะช่วยเหลือคุณหรือจัดหาตัวอย่างโค้ดในภาษาเพิ่มเติมหากจำเป็น

รองรับฟีด/ปลายทางใดบ้าง?

WebSocket API ของเรามีฟีดข้อมูลตลาดแบบเรียลไทม์ ฟีดข้อมูลบัญชี และปลายทางการซื้อขายที่หลากหลาย รายการฟีด/ปลายทางที่มีทั้งหมด พร้อมรายละเอียดการนำไปใช้งานสำหรับแต่ละฟีด/ปลายทาง สามารถดูได้ในเอกสารประกอบ WebSocket API ของเรา

ฉันจะรู้ได้อย่างไรว่าเชื่อมต่อสำเร็จแล้ว? ฉันจะรู้ได้อย่างไรว่ายังคงเชื่อมต่ออยู่?

เมื่อสมัครรับฟีด ข้อความ {u'event': u'heartbeat'} จะได้รับด้วยความถี่ 1 heartbeat ต่อวินาที

Heartbeats จะไม่ได้รับหากได้รับข้อความอื่น ๆ (ข้อมูลตลาด ข้อมูลบัญชี ฯลฯ) แทน การรับข้อมูลตลาดหรือข้อมูลบัญชีขึ้นอยู่กับฟีดที่คุณสมัครรับ

หากคุณสมัครรับฟีดของคู่สกุลเงินที่มีปริมาณการซื้อขายต่ำ คุณอาจได้รับ heartbeats เป็นเวลานาน

หากคุณยกเลิกการสมัครรับฟีด คุณจะไม่ได้รับ heartbeats หรือข้อมูลการซื้อขายอีกต่อไป และหลังจากไม่ได้สมัครรับฟีดใด ๆ เป็นเวลา 1 นาที คุณจะถูกตัดการเชื่อมต่อจากฟีด WebSockets

เมื่อใดและทำไม WebSocket จึงส่งข้อมูลที่อัปเดต?

เมื่อใดและทำไมข้อมูลตลาดหรือข้อมูลบัญชีจึงได้รับ ขึ้นอยู่กับฟีดที่คุณสมัครรับ ตัวอย่างเช่น:

Ticker: เมื่อมีการซื้อขายหรือชุดการซื้อขายสำหรับคู่สกุลเงิน ข้อความ ticker จะถูกเผยแพร่สำหรับคู่นั้น คุณจะได้รับข้อความนี้ก็ต่อเมื่อคุณสมัครรับฟีด ticker สำหรับคู่นี้เท่านั้น

Trade: ในทำนองเดียวกัน เมื่อมีการซื้อขายหรือชุดการซื้อขายสำหรับคู่สกุลเงิน ข้อความ trade ก็จะถูกเผยแพร่สำหรับคู่นั้นด้วย คุณจะได้รับข้อความนี้ก็ต่อเมื่อคุณสมัครรับฟีด trade สำหรับคู่นี้เท่านั้น

OHLC: ช่วงเวลา OHLC ที่อัปเดตจะถูกเผยแพร่สำหรับแต่ละช่วงเวลาเมื่อมีการซื้อขายหรือชุดการซื้อขายสำหรับคู่สกุลเงิน คุณจะได้รับการอัปเดตสำหรับช่วงเวลาที่คุณสมัครรับเท่านั้น หลังจากข้ามขอบเขตช่วงเวลา จะไม่มีการส่งข้อความจนกว่าจะมีการซื้อขายครั้งถัดไป

Book: สแนปช็อตเริ่มต้นของสมุดคำสั่งซื้อที่มีความลึกที่เลือกจะถูกเผยแพร่เมื่อสมัครรับฟีด book ครั้งแรก

เมื่อมีการเพิ่มคำสั่งซื้อใหม่ในสมุดคำสั่งซื้อ หรือมีการซื้อขายที่ส่งผลกระทบต่อความลึกของสมุดคำสั่งซื้อที่คุณสมัครรับ ข้อความจะถูกเผยแพร่ซึ่งมีข้อมูลอัปเดตสมุดคำสั่งซื้อสำหรับระดับราคาและปริมาณที่ได้รับผลกระทบ การอัปเดตเหล่านี้สามารถมีเฉพาะ bids, asks หรือทั้ง bids และ asks ดูวิธีสร้างสมุดคำสั่งซื้อด้านล่างสำหรับรายละเอียด

Spread: เมื่อมีการวางคำสั่งซื้อ bid สูงสุดใหม่หรือ ask ต่ำสุดใหม่ หรือมีการซื้อขายที่เปลี่ยนแปลงราคา bid ที่ดีที่สุดหรือ ask ที่ดีที่สุด ข้อความ spread จะถูกเผยแพร่พร้อมกับราคา bid และ ask ที่อัปเดต

ฟีด WebSocket ให้ข้อมูลย้อนหลังหรือเฉพาะข้อมูลปัจจุบันเท่านั้น?

ฟีดข้อมูลตลาด WebSocket ให้ข้อมูลปัจจุบันเท่านั้น อย่างไรก็ตาม เป็นไปได้ที่จะเชื่อมต่อกับ WebSocket API สำหรับข้อมูลปัจจุบันและ REST API สำหรับข้อมูลย้อนหลังพร้อมกัน

การใช้พารามิเตอร์ reqid

คำขอสมัครรับข้อมูลสามารถรวมพารามิเตอร์ reqid ที่ไคลเอนต์ให้มา ซึ่งสามารถใช้ในภายหลังเพื่อจับคู่คำขอสมัครรับ WebSocket ที่ต้องการกับ ID ช่องสำหรับการสมัครรับนั้น

โปรดทราบว่าหากคุณทำการสมัครรับ WebSocket หลายรายการพร้อมกัน ทั้งหมดจะได้รับค่า reqid เดียวกัน หากต้องการกำหนดค่า reqid ที่แตกต่างกัน แต่ละฟีดจะต้องสมัครรับแยกกัน

ฉันต้องการรายละเอียดเพิ่มเติม ฉันจะหาได้จากที่ไหน?

ข้อมูลจำเพาะ WebSocket API ฉบับสมบูรณ์มีอยู่ในเอกสารประกอบ WebSocket API

ความแตกต่างระหว่างสัญลักษณ์คู่สกุลเงินใน REST และ WebSocket APIs

WebSocket API ยอมรับเฉพาะสัญลักษณ์คู่สกุลเงินในรูปแบบ ISO 4217-A3 เช่น XBT/USD

ปลายทาง AssetPairs ของ REST API สามารถใช้เพื่อแปลสัญลักษณ์ระหว่างเวอร์ชัน REST API (เช่น XBTUSD หรือ XXBTZUSD) และเวอร์ชัน WebSocket API (เช่น XBT/USD)

https://api.kraken.com/0/public/AssetPairs

ฟิลด์ wsname ให้สัญลักษณ์ WebSocket API

วิธีสร้างสมุดคำสั่งซื้อ

ฟีด book ของ WebSocket API เป็นฟีดที่ซับซ้อนที่สุดในบรรดาฟีด WebSocket ทั้งหมด แต่ตราบใดที่ข้อความฟีด book ถูกตีความอย่างถูกต้อง ก็สามารถรักษาสมุดคำสั่งซื้อในเครื่องได้ด้วยโค้ดเพียงไม่กี่บรรทัด

หน้าสนับสนุน WebSocket API ของเรามีคำแนะนำโดยละเอียดสำหรับการตีความข้อความฟีด book พร้อมด้วยตัวอย่างบันทึกฟีด book และตัวอย่างโค้ด (ใน Python) สำหรับการรักษาสมุดคำสั่งซื้อในเครื่องที่ถูกต้อง

ข้อจำกัดการเชื่อมต่อ WebSocket API คืออะไร?

WebSocket API จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดเพื่อป้องกันการใช้งานในทางที่ผิด (เช่น การโจมตี DDoS เป็นต้น) หากไคลเอนต์ WebSocket ของคุณทำการเชื่อมต่อมากเกินไปพร้อมกัน คุณจะได้รับข้อความแสดงข้อผิดพลาดดังต่อไปนี้:

{“error”: {“message”: “You have reached maximum capacity for WebSocket connections. Please reach out to Kraken support team for any questions.“, “hint”: “Your code may be reconnecting too often or when it has no need to.“, “name”: “WebSocket connection rate error”}}

WebSocket API อนุญาตให้มีการสมัครรับฟีดหลายรายการผ่านการเชื่อมต่อ WebSocket เดียว (เช่น การสมัครรับข้อมูลตลาดที่มีทั้งหมดสำหรับคู่สกุลเงิน XBT/USD ผ่านการเชื่อมต่อเดียว) ดังนั้นจึงเป็นไปได้ที่จะสตรีมข้อมูลตลาดที่มีทั้งหมดสำหรับคู่สกุลเงินทั้งหมดโดยไม่ถึงขีดจำกัดการเชื่อมต่อ WebSocket

ข้อจำกัดอัตรา WebSocket API คืออะไร?

ข้อจำกัดอัตราการซื้อขายเดียวกันนี้ใช้กับอินเทอร์เฟซการป้อนคำสั่งซื้อทั้งหมด (เว็บไซต์, Kraken Terminal, REST และ WebSocket APIs) และมีการอธิบายโดยละเอียดในหน้าสนับสนุนข้อจำกัดอัตราของเรา

ข้อจำกัดอัตราข้อความของการเชื่อมต่อ WebSocket API เดียวจะแตกต่างกันไปขึ้นอยู่กับโหลดของระบบ ไคลเอนต์ WebSocket API จะได้รับข้อความแสดงข้อผิดพลาด {"Error": "Exceeded msg rate"} เมื่อเกินข้อจำกัดอัตราข้อความ

การซื้อขาย (การวาง/ยกเลิกคำสั่งซื้อ) ผ่าน WebSocket API

การซื้อขายผ่าน WebSocket API มีให้บริการผ่านปลายทาง addOrder และ cancelOrder ซึ่งใช้สำหรับวางคำสั่งซื้อใหม่และยกเลิกคำสั่งซื้อที่มีอยู่ (เปิดอยู่) ตามลำดับ

ปลายทางการซื้อขาย WebSocket มีให้บริการผ่านการเชื่อมต่อ WebSocket ส่วนตัวเดียวกัน (wss://ws-auth.kraken.com/) เช่นเดียวกับฟีดการจัดการบัญชีส่วนตัว (openOrders และ ownTrades)

รายละเอียดทั้งหมดเกี่ยวกับปลายทางการซื้อขายมีอยู่ในเอกสารประกอบ WebSocket API และหน้าสนับสนุน WebSocket API ของเราให้ข้อมูลเพิ่มเติมและตัวอย่างสำหรับการใช้ปลายทางการซื้อขายในโค้ดของคุณเอง

ทำไมฉันจึงได้รับข้อผิดพลาด 403 เมื่อเชื่อมต่อกับ WebSocket API?

การเชื่อมต่อ WebSocket API จะถูกส่งผ่าน Cloudflare ดังนั้นการตั้งค่าความปลอดภัยใด ๆ ที่ Cloudflare นำมาใช้สามารถส่งผลกระทบต่อการเชื่อมต่อทั้ง URL สาธารณะ (wss://ws.kraken.com) และส่วนตัว (wss://ws-auth.kraken.com)

Cloudflare กำหนดให้ต้องใช้ Server Name Indication (SNI) สำหรับการเชื่อมต่อ TLS ทั้งหมด มิฉะนั้นการเชื่อมต่อ WebSocket จะล้มเหลว และจะส่งคืนข้อผิดพลาด HTTP 403 Forbidden แทน หน้าสนับสนุนของ Cloudflare ให้รายละเอียดเพิ่มเติมเกี่ยวกับข้อกำหนด TLS SNI ของพวกเขา

ไลบรารี Python WebSocket API อย่างเป็นทางการของเราได้รับการอัปเดตเพื่อรองรับ TLS SNI แต่ไลบรารี WebSocket API ของบุคคลที่สามบางรายอาจยังคงได้รับผลกระทบ โปรดติดต่อทีมสนับสนุน API ของเราหากคุณต้องการความช่วยเหลือในการอัปเดตโค้ด WebSocket API ของคุณเพื่อรองรับ TLS SNI

ความช่วยเหลือเกี่ยวกับ WebSocket API

โปรดติดต่อทีมสนับสนุน API ของเรา หากคุณต้องการความช่วยเหลือในการนำไคลเอนต์ WebSocket API ของคุณไปใช้งาน