1. Khi tài sản của người dùng bị thay đổi:
- Chỉ tài sản này và thông tin số dư của tài sản sẽ được thông báo
- Các tài sản và thông tin khác sẽ không còn được thông báo kể cả khi số dư có thể không bằng 0
- Nếu thay đổi tài sản không đi kèm với bất kỳ thay đổi vị thế nào thì vị thế "P" sẽ chỉ trả về một [] trống
2. Khi thay đổi vị thế của mã hoặc loại ký quỹ của mã bị thay đổi:
- “P” sẽ thông báo các chi tiết trong vị thế “BOTH” của mã này
- Nếu thay đổi xảy ra ở trong vị thế "LONG" hoặc "SHORT", vị thế "LONG" hoặc "SHORT" đã thay đổi của mã này sẽ được thông báo
- Vị thế isolated "LONG" hoặc "SHORT" ban đầu của mã này cũng sẽ được thông báo
- Thông tin vị thế của các mã khác sẽ không còn được thông báo nữa, ngay cả khi vị thế của những mã đó có thể không bằng 0
3. Nói tóm lại, phải lấy thông tin đầy đủ về tài sản và vị thế thông qua các điểm cuối còn lại có liên quan (GET /fapi/v2/account và GET /fapi/v2/positionRisk) cùng dữ liệu vị thế hoặc tài sản được lưu trong bộ nhớ đệm cục bộ có thể được cập nhật qua sự kiện ACCOUNT_UPDATE trong Websocket USER-DATA-STREAM với thông tin về tài sản hoặc vị thế đã thay đổi.
Để hiểu rõ hơn về việc nâng cấp, bạn có thể tìm thấy một số ví dụ về kịch bản khác nhau bên dưới:
Hãy xem xét một người dùng nắm giữ 94,89888561 USDT và 0,01575839 BNB trong Ví Futures của mình cùng 0,01 BTCUSDT trong vị thế LONG và -0,01 ETHUSDT trong vị trí SHORT. Nếu người dùng:
- Chuyển 0,01 BNB vào tài khoản Futures
Trước khi nâng cấp | Sau khi nâng cấp |
{ "e://ACCOUNT_UPDATE", "T":1603093193280, "E":1603093193284, "a":{ "B":[ { "a":"USDT", "wb":"94,91018561", "cw":"93,70831461" }, { "a":"BNB", "wb":"0,02575839", "cw":"0" } ], "P":[ { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-147,28880096", "up":"0", "mt":"isolated", "iw":"0", "ps":"BOTH" }, { "s":"BTCUSDT", "pa":"0.010", "ep":"11445,71000", "cr":"-23,20024001", "up":"0,17770", "mt":"isolated", "iw":"1,20187100", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-6,04296000", "up":"0", "mt":"isolated", "iw":"0", "ps":"SHORT" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,00057000", "up":"0", "mt":"cross", "iw":"0", "ps":"BOTH" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-385,79173997", "up":"0", "mt":"cross", "iw":"0", "ps":"LONG" }, { "s":"ETHUSDT", "pa":"-0,010", "ep":"375,74000", "cr":"-0,19160000", "up":"0,00149", "mt":"cross", "iw":"0", "ps":"SHORT" } ], "m":"DEPOSIT" } } | { "e://ACCOUNT_UPDATE", "T":1603093193280, "E":1603093193284, "a":{ "B":[ // USDT không được thông báo do không có thay đổi số dư { "a:"BNB", // BNB được thông báo khi số dư cập nhật. "wb":"0,02575839", "cw":"0" } ], "P":[], // Không có dữ liệu vị thế nào được thông báo vì không có thay đổi vị thế. "m":"DEPOSIT" } } |
2. Đóng vị thế short ETHUSDT
Trước khi nâng cấp | Sau khi nâng cấp |
{ "e://ACCOUNT_UPDATE", "T":1603093588546, "E":1603093588553, "a":{ "B":[ { "a":"USDT", "wb":"94,91428561", "cw":"93,71241461" }, { "a":"BNB", "wb":"0,02571331", "cw":"0" } ], "P":[ { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-147,28880096", "up":"0", "mt":"isolated", "iw":"0", "ps":"BOTH" }, { "s":"BTCUSDT", "pa":"0.010", "ep":"11445,71000", "cr":"-23,20024001", "up":"0,13910", "mt":"isolated", "iw":"1,20187100", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-6,04296000", "up":"0", "mt":"isolated", "iw":"0", "ps":"SHORT" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,00057000", "up":"0", "mt":"cross", "iw":"0", "ps":"BOTH" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-385,79173997", "up":"0", "mt":"cross", "iw":"0", "ps":"LONG" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,18750000", "up":"0", "mt":"cross", "iw":"0", "ps":"SHORT" } ], "m":"ORDER" } } | { "e://ACCOUNT_UPDATE", "T":1603093588546, "E":1603093588553, "a":{ "B":[ { "a://USDT", // USDT được thông báo vì thay đổi do lãi lỗ đã ghi nhận. "wb":"94,91428561", "cw":"93,71241461" }, { "a:"BNB", // BNB được thông báo vì thay đổi do việc đốt phí giao dịch BNB. "wb":"0,02571331", "cw":"0" } ], "P":[ // Chỉ vị thế thay đổi của ETHUSDT được thông báo. { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,00057000", "up":"0", "mt":"cross", "iw":"0", "ps://BOTH" // CẢ HAI vị thế sẽ luôn được thông báo. }, // Vị thế LONG không được thông báo vì chưa được khởi tạo. { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,18750000", "up":"0", "mt":"cross", "iw":"0", "ps://SHORT" // vị thế SHORT được thông báo vì thay đổi từ sự kiện này. } ], "m":"ORDER" } } |
3. Thay đổi ETHUSDT từ chế độ CROSS sang chế độ ISOLATED
Trước khi nâng cấp | Sau khi nâng cấp |
{ "e://ACCOUNT_UPDATE", "T":1603094890011, "E":1603094890017, "a":{ "B":[ { "a":"USDT", "wb":"94,90282656", "cw":"93,71241461" }, { "a":"BNB", "wb":"0,02571331", "cw":"0" } ], "P":[ { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-147,28880096", "up":"0", "mt":"isolated", "iw":"0", "ps":"BOTH" }, { "s":"BTCUSDT", "pa":"0.010", "ep":"11445,71000", "cr":"-23,20024001", "up":"0,03240", "mt":"isolated", "iw":"1,19041195", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-6,04296000", "up":"0", "mt":"isolated", "iw":"0", "ps":"SHORT" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,00057000", "up":"0", "mt":"isolated", "iw":"0", "ps":"BOTH" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-385,79173997", "up":"0", "mt":"isolated", "iw":"0", "ps":"LONG" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,18750000", "up":"0", "mt":"isolated", "iw":"0", "ps":"SHORT" } ], "m":"MARGIN_TYPE_CHANGE" } } | { "e://ACCOUNT_UPDATE", "T":1603094890011, "E":1603094890017, "a":{ "B":[ { "a":"USDT", // USDT được thông báo vì là tài sản ký quỹ. "wb":"94,90282656", "cw":"93,71241461" } ], "P":[ // Chỉ ETHUSDT được thông báo vì có thay đổi chế độ ( CROSS thành ISOLATED). { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,00057000", "up":"0", "mt":"isolated", "iw":"0", "ps://BOTH" // CẢ HAI vị thế sẽ luôn được thông báo. }, // Vị thế LONG không được thông báo vì chưa được khởi tạo. { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0,18750000", "up":"0", "mt":"isolated", "iw":"0", "ps://SHORT" // Vị thế SHORT được thông báo vào thời điểm khởi tạo. } ], "m":"MARGIN_TYPE_CHANGE" } } |