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

เรียน ผู้ใช้งาน 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 ไม่ใช่ขั้นตอนบังคับ แต่เมื่อดำเนินการย้ายระบบสำเร็จแล้ว ระบบจะยกเลิกคำสั่งแบบความถี่ต่ำโดยอัตโนมัติ และโอนสินทรัพย์แบบความถี่ต่ำไปยังบัญชีแบบความถี่สูง
หมายเหตุสำคัญ:
-
การใช้งานบัญชีอาจถูกระงับชั่วคราว (มีผลกระทบทั้งผู้ใช้งาน C-end และผู้ใช้งาน API);
ระหว่างการดำเนินการย้ายระบบ บัญชีผู้ใช้งานจะไม่สามารถใช้งานได้ชั่วคราวเป็นเวลา 2-3 นาที ซึ่งรวมถึงฟังก์ชันการสอบถามสินทรัพย์ การเทรด และการโอนย้าย กรุณาวางแผนการดำเนินการล่วงหน้าเพื่อหลีกเลี่ยงผลกระทบต่อการทำธุรกรรม
-
การยกเลิกคำสั่งแบบความถี่ต่ำโดยบังคับ;
หากผู้ใช้งานไม่ได้ยกเลิกคำสั่งแบบความถี่ต่ำล่วงหน้า ระบบจะทำการยกเลิกคำสั่งแบบธรรมดาความถี่ต่ำและคำสั่งขั้นสูงที่ยังไม่ถูกดำเนินการโดยอัตโนมัติระหว่างกระบวนการย้ายระบบ
-
สินทรัพย์จะแสดงสถานะเป็น "frozen" ชั่วคราว;
ในช่วงเตรียมการย้ายระบบ อาจมีการแสดงสินทรัพย์ความถี่สูงว่าเป็น "frozen" ในอินเทอร์เฟซเก่า และสถานะจะกลับมาเป็นปกติหลังการย้ายระบบเสร็จสมบูรณ์
-
คำแนะนำเกี่ยวกับความเข้ากันได้ของอินเทอร์เฟซ;
อินเทอร์เฟซเก่าจะไม่รองรับการสอบถามข้อมูลบัญชีแบบความถี่สูงอีกต่อไป ขอให้ดำเนินการเปลี่ยนแปลงล่วงหน้า มิฉะนั้นอาจเกิดข้อผิดพลาดได้
-
การย้ายระบบอย่างเป็นทางการจะเริ่มต้นหลังจากการแจ้งเตือนผ่านอีเมล 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 ทั่วโลก>>>
คำปฏิเสธความรับผิดชอบ: หน้านี้แปลโดยใช้เทคโนโลยี AI (ขับเคลื่อนโดย GPT) เพื่อความสะดวกของคุณ สำหรับข้อมูลที่ถูกต้องที่สุด โปรดดูต้นฉบับภาษาอังกฤษ