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

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

04/07/2568 06:33:02

Custom Image

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

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

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

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

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

2.1 ผู้ใช้งานทั่วไป (C-end users)

  • ประสบการณ์การใช้งานบน Web/App จะยังคงไม่มีการเปลี่ยนแปลงทั้งก่อนและหลังการย้าย

2.2 ผู้ใช้งาน API

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

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

ขั้นตอนที่ 1: ทำการลบคำสั่งซื้อที่มีความถี่ต่ำด้วยตนเอง

a. ผู้ใช้งานต้องยกเลิกคำสั่งที่ดำเนินการโดย API ความถี่ต่ำและ C-end (Web/App) ด้วยตัวเอง;

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

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

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

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

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

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

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

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

หมายเหตุสำคัญ:

  1. การใช้งานบัญชีอาจถูกระงับชั่วคราว (มีผลกระทบทั้งผู้ใช้งาน C-end และผู้ใช้งาน API);

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

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

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

  1. สินทรัพย์จะแสดงสถานะเป็น "frozen" ชั่วคราว;

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

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

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

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

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

รายละเอียดการย้ายระบบ:

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

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

    • การสอบถามสินทรัพย์ในบัญชีหลักประกันแบบ Cross margin: /api/v3/margin/accounts

    • การสอบถามสินทรัพย์ในบัญชีหลักประกันแบบ Isolated margin: /api/v3/isolated/accounts

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

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

การค้นหาประวัติธุรกรรม

1. V1 Interface: /api/v1/accounts/ledgers

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

2. V3 Interface: /api/v3/hf/margin/account/ledgers

  • รองรับเฉพาะการค้นหาธุรกรรมสำหรับบัญชีที่มีความถี่สูง โดยมีช่วงเวลาการค้นหาจำกัดอยู่ที่ 3 วันล่าสุดเท่านั้น

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

การโอน

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

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

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

การค้นหาประวัติคำสั่งซื้อ

1. V1 Interface: /api/v1/orders?status=done

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

2. V3 Interface: /api/v3/hf/margin/orders/done

  • รองรับเฉพาะการค้นหาคำสั่งซื้อที่มีความถี่สูง และสามารถแสดงข้อมูลได้เฉพาะ 3 วันล่าสุดเท่านั้น ผู้ใช้สามารถเลือกตามความต้องการ

การวางคำสั่งซื้อ/การยกเลิกคำสั่งซื้อ/การค้นหาคำสั่งซื้อที่ยังคงใช้งานอยู่

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

2. V3 Interface: รองรับการวาง ยกเลิก และค้นหาคำสั่งซื้อที่ใช้งานอยู่สำหรับคำสั่งซื้อที่มีความถี่สูง

คำสั่งซื้อที่มีความถี่สูงและต่ำจะไม่สามารถใช้งานร่วมกันได้ รวมถึงฟังก์ชัน take-profit และ stop-loss ผู้ใช้ควรใช้อินเทอร์เฟซที่เหมาะสมกับประเภทคำสั่งซื้อ

การเปลี่ยนแปลงอินเทอร์เฟซหลังการโยกย้าย:

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

รายการ

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

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

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

Regular Order: /api/v1/margin/order

Stop Order: /api/v1/stop-order

คำสั่งซื้อแบบปกติ: /api/v3/hf/margin/order คำสั่งซื้อแบบหยุด: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

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

ตาม orderId: /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

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} ค้นหาคู่เทรดที่ยังเปิด: /api/v3/hf/margin/order/active/symbols


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

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

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

ทีมงาน KuCoin

ค้นพบคริปโตเจมตัวต่อไปได้ที่ KuCoin!

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

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

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

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

เข้าร่วมชุมชน KuCoin ทั่วโลก>>>

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