การประกาศอัปเกรด API ของ KuCoin Margin

04/07/2025 14:33:02

กำหนดเอง

เรียนผู้ใช้งาน KuCoin

เพื่อให้ผู้ใช้ได้รับสภาพแวดล้อมการซื้อขายที่ดีขึ้นและปรับปรุงประสบการณ์การซื้อขาย KuCoin กำลังดำเนินการย้ายและอัปเกรด API เลเวอเรจในรูปแบบความถี่สูง การย้ายครั้งนี้จะดำเนินการเป็นชุดๆ และคาดว่าจะเสร็จสิ้นภายในสิ้นเดือนมีนาคม 2026

1. ขอบเขตของการย้าย:

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

2. ผลกระทบของการย้าย:

     2.1 ผู้ใช้ที่ไม่ใช้ API (ผู้ใช้ปลายทาง)

  • ประสบการณ์ของผู้ใช้บนเว็บ/แอปจะไม่เปลี่ยนแปลงก่อนและหลังการย้าย

     2.2 ผู้ใช้ API

  • การย้ายครั้งนี้จะมีผลกระทบบางประการต่อวิธีการเรียกใช้อินเทอร์เฟซ API และการแสดงสถานะสินทรัพย์ การย้ายนี้จะแจ้งให้ทราบเป็นชุดๆ กรุณาดำเนินการตามที่เกี่ยวข้องทันทีหลังจากได้รับอีเมลแจ้งเตือน ระบบจะดำเนินการย้ายหลังจากส่งอีเมลแล้ว 7 วัน (เพื่อลดผลกระทบ คุณสามารถสลับไปใช้ API ความถี่สูงล่วงหน้าได้)

3. กระบวนการย้าย:

ขั้นตอนที่ 1: ทำความสะอาดคำสั่งที่มีความถี่ต่ำด้วยตนเอง

ก. ผู้ใช้ต้องยกเลิกคำสั่งซื้อที่วางไว้ผ่าน API ความถี่ต่ำและ C-end (เว็บ/แอป) เอง

b. คำสั่งความถี่สูงไม่จำเป็นต้องยกเลิก;

  • หากคุณไม่ยกเลิกด้วยตนเอง ระบบจะยกเลิกคำสั่งอัตโนมัติในระหว่างกระบวนการย้าย (รวมถึงคำสั่งทั่วไปและคำสั่งขั้นสูง)

  • หากคุณไม่ยืนยันสถานะคำสั่งซื้อ โปรดติดต่อฝ่ายบริการลูกค้าเพื่อขอคำปรึกษา

ขั้นตอนที่ 2: โอนสินทรัพย์ที่มีความถี่ต่ำด้วยตนเอง (ผู้ใช้ API)

ก. ผู้ใช้ต้องโอนสินทรัพย์จากบัญชีความถี่ต่ำไปยังบัญชีความถี่สูงด้วยตนเอง และเปลี่ยนไปใช้อินเทอร์เฟซ API ใหม่ (ดูรายละเอียดใน api-doc)

b. รับขีดจำกัดการโอน - KUCOIN API ในขณะนี้ สินทรัพย์ที่อยู่ที่ C-end (เว็บและแอป) จะแสดงเป็น "ถูกระงับ" และไม่สามารถดำเนินการสั่งซื้อแบบความถี่สูงได้

ขั้นตอนที่ 3: เริ่มการย้าย

ขั้นตอนที่ 1 และ 2 ไม่จำเป็นต้องทำ แต่เมื่อการย้ายถ่ายโอนดำเนินการแล้ว ระบบจะยกเลิกคำสั่งที่มีความถี่ต่ำโดยอัตโนมัติและโอนสินทรัพย์ที่มีความถี่ต่ำไปยังบัญชีที่มีความถี่สูง

ข้อควรทราบสำคัญ:

  1. บัญชีไม่สามารถใช้งานชั่วคราว (ผู้ใช้ปลายทาง C และผู้ใช้ API จะได้รับผลกระทบ)

ในระหว่างการดำเนินการย้าย บัญชีผู้ใช้จะไม่สามารถใช้งานได้ชั่วคราวเป็นเวลา 2-3 นาที ซึ่งรวมถึงฟังก์ชันการสอบถามสินทรัพย์ การซื้อขาย และการโอน โปรดจัดการดำเนินการล่วงหน้าเพื่อหลีกเลี่ยงผลกระทบต่อธุรกรรม

  1. การยกเลิกบังคับสำหรับคำสั่งที่มีความถี่ต่ำ;

หากผู้ใช้ไม่ยกเลิกคำสั่งความถี่ต่ำล่วงหน้า ระบบจะยกเลิกคำสั่งธรรมดาและคำสั่งขั้นสูงที่ยังไม่ได้ดำเนินการอย่างบังคับในระหว่างกระบวนการย้าย

  1. สินทรัพย์จะแสดงเป็น “ถูกล็อก” ชั่วคราว;

ในระหว่างขั้นตอนการเตรียมการย้ายข้อมูล สินทรัพย์ที่มีความถี่สูงอาจแสดงเป็น “ถูกระงับ” ในอินเทอร์เฟซเดิม และจะกลับสู่สภาวะปกติหลังจากย้ายข้อมูลเสร็จสิ้น

  1. เคล็ดลับเกี่ยวกับความเข้ากันได้ของอินเทอร์เฟซ;

อินเทอร์เฟซเก่าจะไม่รองรับการสอบถามที่เกี่ยวข้องกับบัญชีแบบความถี่สูงอีกต่อไป โปรดดำเนินการเปลี่ยนแปลงให้เสร็จสิ้นล่วงหน้า มิฉะนั้นอาจเกิดข้อผิดพลาด

  1. การย้ายอย่างเป็นทางการจะเกิดขึ้นภายใน 7 วันหลังจากได้รับอีเมลแจ้งเตือน;

การย้ายระบบอย่างเป็นทางการจะเริ่มขึ้นภายใน 7 วันหลังจากส่งอีเมลแจ้งเตือน ผู้ใช้ควรติดตามกล่องจดหมายของตนอย่างใกล้ชิดและดำเนินการเตรียมความพร้อมทั้งหมดก่อนวันย้ายระบบ เพื่อให้การเปลี่ยนผ่านเป็นไปอย่างราบรื่นและหลีกเลี่ยงการหยุดให้บริการ

เนื้อหาการย้ายแบบละเอียด:

การสอบถามสินทรัพย์

  •  เราขอแนะนำให้ใช้อินเทอร์เฟซ API ใหม่สำหรับการสอบถามสินทรัพย์:

    • การสอบถามสินทรัพย์บัญชี Cross Margin: /api/v3/margin/accounts

    • การสอบถามสินทรัพย์บัญชี Isolated Margin: /api/v3/isolated/accounts

  •  หลังจากการย้ายข้อมูล ข้อมูลสินทรัพย์ก่อนและหลังการย้ายจะยังคงสอดคล้องกัน เมื่อการย้ายข้อมูลเสร็จสิ้น การสอบถามทั้ง margin, margin_v2 และ ALL จะให้ผลลัพธ์ที่สอดคล้องกัน (เช่นเดียวกันสำหรับบัญชีแบบแยกเฉพาะ)

หมายเหตุ: อินเทอร์เฟซการสอบถามสินทรัพย์เก่า (/api/v1/margin/account สำหรับ cross-margin และ /v1/isolated/accounts สำหรับ isolated margin) จะยังคงใช้งานได้หลังการย้าย แต่สินทรัพย์ที่มีความถี่สูงจะแสดงเป็น “ถูกระงับ” สำหรับผู้ใช้ที่ยังไม่ได้ย้าย

การสอบถามบันทึกธุรกรรม

1. อินเทอร์เฟซ V1: /api/v1/accounts/ledgers

  • สามารถสอบถามสมุดบัญชีสำหรับบัญชีความถี่สูงและบัญชีความถี่ต่ำก่อนและหลังการย้าย ด้วยช่วงเวลาเดียวกับก่อนหน้า

2. อินเทอร์เฟซ V3: /api/v3/hf/margin/account/ledgers

  • สิ่งนี้รองรับการสอบถามธุรกรรมบัญชีความถี่สูงเท่านั้น โดยมีช่วงเวลาจำกัดในสามวันที่ผ่านมา

ผู้ใช้สามารถเลือกอินเทอร์เฟซตามความต้องการของตน

การโอน

  •  อินเทอร์เฟซการโอนยังคงเหมือนเดิม สามารถใช้อินเทอร์เฟซก่อนหน้าสำหรับการโอนระหว่างบัญชีความถี่สูงและบัญชีความถี่ต่ำได้

    • ก่อนการย้าย: รองรับการโอนระหว่างบัญชีความถี่สูงและบัญชีความถี่ต่ำภายในผู้ใช้เดียวกัน

    • หลังจากการย้าย: หลักประกันและ margin_v2 จะถูกพิจารณาว่าเป็นบัญชีเดียวกัน และการโอนระหว่างบัญชีทั้งสองนี้จะไม่ได้รับการสนับสนุนอีกต่อไป (ในทำนองเดียวกันสำหรับ Isolated Margin)

การสอบถามคำสั่งซื้อในอดีต

1. อินเทอร์เฟซ V1: /api/v1/orders?status=done

  • สามารถสอบถามคำสั่งประวัติได้สำหรับคำสั่งความถี่สูงและคำสั่งความถี่ต่ำ โดยใช้ช่วงเวลาเดียวกัน

2. อินเทอร์เฟซ V3: /api/v3/hf/margin/orders/done

  • สิ่งนี้รองรับการสอบถามคำสั่งความถี่สูงเท่านั้น และสามารถคืนข้อมูลสำหรับสามวันที่ผ่านมาเท่านั้น ผู้ใช้สามารถเลือกตามความต้องการของตนเอง

การวางคำสั่งซื้อ/การยกเลิกคำสั่งซื้อ/การสอบถามคำสั่งซื้อที่ยังไม่ถูกดำเนินการ

1. อินเทอร์เฟซ V1: รองรับการสั่งซื้อ ยกเลิก และสอบถามคำสั่งความถี่ต่ำที่ยังคงอยู่

2. อินเทอร์เฟซ V3: รองรับการวาง ยกเลิก และสอบถามคำสั่งความถี่สูงที่ยังคงอยู่

คำสั่งความถี่สูงและคำสั่งความถี่ต่ำไม่สามารถใช้งานร่วมกันได้ รวมถึงฟังก์ชันการขายทำกำไรและการขายป้องกันความเสียหาย ผู้ใช้ควรใช้อินเทอร์เฟซที่เหมาะสมตามประเภทคำสั่ง

การเปลี่ยนแปลงอินเทอร์เฟซการย้ายข้อมูล:

  • หมายเหตุ: ขอแนะนำให้ชี้แจงการเปลี่ยนแปลงอินเทอร์เฟซที่เกี่ยวข้องก่อนและหลังการย้ายล่วงหน้า เพื่อหลีกเลี่ยงผลกระทบต่อการใช้งาน

การกระทำ

ก่อนอินเทอร์เฟซการย้าย

หลังจากอินเทอร์เฟซการย้าย

การวางคำสั่งซื้อ

คำสั่งปกติ: /api/v1/margin/order

Stop Order: /api/v1/stop-order

คำสั่งปกติ: /api/v3/hf/margin/order Stop Order: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

ยกเลิกคำสั่งซื้อ

ตามคำสั่งซื้อ: /api/v1/orders/{orderId}

โดย clientOid: /api/v1/order/client-order/{clientOid}

ยกเลิกเป็นกลุ่ม: /api/v1/orders

ตาม orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

โดย clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}

การยกเลิกเป็นกลุ่ม: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

การสอบถามคำสั่งซื้อที่ยังคงอยู่

/api/v1/orders?status=active

/query คู่เทรดที่ใช้งานอยู่: /api/v3/hf/margin/order/active/symbols

คำเตือนความเสี่ยง

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

ขอบคุณสำหรับการสนับสนุนของคุณ!

ทีม KuCoin

ค้นหาคริปโตที่มีศักยภาพถัดไปบน KuCoin!

สมัครสมาชิกบน KuCoin ตอนนี้! >>>

ดาวน์โหลดแอป KuCoin >>>

ติดตามเราบน X (Twitter) >>>

เข้าร่วมกับเราบน Telegram >>>

เข้าร่วมชุมชนระดับโลกของ KuCoin >>>

คำปฏิเสธความรับผิดชอบ: หน้านี้แปลโดยใช้เทคโนโลยี AI (ขับเคลื่อนโดย GPT) เพื่อความสะดวกของคุณ สำหรับข้อมูลที่ถูกต้องที่สุด โปรดดูต้นฉบับภาษาอังกฤษ