1. Când un activ al unui utilizator este modificat:
- Doar acest activ și informațiile despre soldul său vor fi transmise
- Alte active și informații nu vor mai fi transmise, chiar dacă soldurile sunt mai mari de 0
- Dacă modificarea activului nu produce nicio schimbare de poziție, poziția „P” va returna doar un [] gol
2. Când o poziție a unui simbol este schimbată sau tipul de marjă al unui simbol este schimbat:
- „P” va transfera detaliile în poziția "AMBELE" a acestui simbol
- Dacă schimbarea are loc în poziția „LONG” sau „SHORT”, poziția „LONG” sau „SHORT” modificată a acestui simbol va fi transmisă
- Poziția izolată „LONG” sau „SHORT” inițializată a acestui simbol va fi, de asemenea, transmisă
- Informațiile de poziție ale altor simboluri nu vor mai fi transmise, chiar dacă pozițiile lor nu pot fi 0
3. Pe scurt, informațiile complete despre active și poziții trebuie obținute prin intermediul punctelor finale rest aferente (GET /fapi/v2/account și GET /fapi/v2/positionRisk), iar datele despre active sau poziții stocate în cache la nivel local pot fi actualizate prin intermediul evenimentului ACCOUNT_UPDATE din Websocket-ul USER-DATA-STREAM cu informațiile despre activele sau pozițiile modificate.
Pentru a înțelege mai bine upgrade-ul, puteți găsi mai jos câteva exemple de scenarii diferite:
Să luăm exemplul unui un utilizator care deține 94,89888561 USDT și 0,01575839 BNB în Portofelul Futures și 0,01 BTCUSDT într-o poziție LONG și -0,01 ETHUSDT într-o poziție SHORT. Dacă utilizatorul:
- Transferă 0,01 BNB în contul Futures
Înainte de upgrade | După upgrade |
{ "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":"iz", "iw":"0", "ps":"BOTH" }, { "s":"BTCUSDT", "pa":"0.010", "ep":"11445.71000", "cr":"-23.20024001", "up":"0.17770", "mt":"iz", "iw":"1.20187100", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-6.04296000", "up":"0", "mt":"iz", "iw":"0", "ps":"SHORT" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.00057000", "up":"0", "mt":"cruce", "iw":"0", "ps":"BOTH" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-385.79173997", "up":"0", "mt":"cruce", "iw":"0", "ps":"LONG" }, { "s":"ETHUSDT", "pa":"-0.010", "ep":"375.74000", "cr":"-0.19160000", "up":"0,00149", "mt":"cruce", "iw":"0", "ps":"SHORT" } ], "m":"DEPOSIT" } } | { "e":"ACCOUNT_UPDATE", "T":1603093193280, "E":1603093193284, "a":{ "B":[ // USDT nu este transmis, deoarece nu există nicio modificare a soldului { "a":"BNB", // BNB este transmis pe măsură ce soldul este actualizat. "wb":"0.02575839", "cw":"0" } ], "P":[], // Nu sunt transmise date de poziție, deoarece nu există nicio schimbare de poziție. "m":"DEPOSIT" } } |
2. Închide poziția Short ETHUSDT
Înainte de upgrade | După upgrade |
{ "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":"iz", "iw":"0", "ps":"BOTH" }, { "s":"BTCUSDT", "pa":"0.010", "ep":"11445.71000", "cr":"-23.20024001", "up":"0.13910", "mt":"iz", "iw":"1.20187100", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-6.04296000", "up":"0", "mt":"iz", "iw":"0", "ps":"SHORT" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.00057000", "up":"0", "mt":"cruce", "iw":"0", "ps":"BOTH" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-385.79173997", "up":"0", "mt":"cruce", "iw":"0", "ps":"LONG" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.18750000", "up":"0", "mt":"cruce", "iw":"0", "ps":"SHORT" } ], "m":"ORDER" } } | { "e":"ACCOUNT_UPDATE", "T":1603093588546, "E":1603093588553, "a":{ "B":[ { "a":"USDT", // USDT este transmis deoarece este modificat de PNL realizat. "wb":"94.91428561", "cw":"93.71241461" }, { "a":"BNB", // BNB este transmis deoarece este modificat de arderea comisionului de tranzacționare a BNB. "wb":"0.02571331", "cw":"0" } ], "P":[ // Numai poziția modificată a ETHUSDT este transmisă. { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.00057000", "up":"0", "mt":"cruce", "iw":"0", "ps":"BOTH" // Pozițiile BOTH vor fi transmise întotdeauna. }, // poziția LONG nu este transmisă, deoarece nu este inițializată încă. { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.18750000", "up":"0", "mt":"cruce", "iw":"0", "ps":"SHORT" // poziția SHORT este transmisă pe măsură ce se schimbă de la acest eveniment. } ], "m":"ORDER" } } |
3. Modifică ETHUSDT din modul CUMULAT în modul IZOLAT
Înainte de upgrade | După upgrade |
{ "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":"iz", "iw":"0", "ps":"BOTH" }, { "s":"BTCUSDT", "pa":"0.010", "ep":"11445.71000", "cr":"-23.20024001", "up":"0,03240", "mt":"iz", "iw":"1.19041195", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"0", "ep":"0,00000", "cr":"-6.04296000", "up":"0", "mt":"iz", "iw":"0", "ps":"SHORT" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.00057000", "up":"0", "mt":"iz", "iw":"0", "ps":"BOTH" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-385.79173997", "up":"0", "mt":"iz", "iw":"0", "ps":"LONG" }, { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.18750000", "up":"0", "mt":"iz", "iw":"0", "ps":"SHORT" } ], "m":"MARGIN_TYPE_CHANGE" } } | { "e":"ACCOUNT_UPDATE", "T":1603094890011, "E":1603094890017, "a":{ "B":[ { "a":"USDT", // USDT este transmis deoarece este activ de marjă. "wb":"94.90282656", "cw":"93.71241461" } ], "P":[ // numai ETHUSDT este transmis, deoarece suportă o schimbare a modului (de la CUMULAT la IZOLAT). { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.00057000", "up":"0", "mt":"iz", "iw":"0", "ps":"BOTH" // Pozițiile BOTH vor fi transmise întotdeauna. }, // poziția LONG nu este transmisă, deoarece nu este inițializată încă. { "s":"ETHUSDT", "pa":"0", "ep":"0,00000", "cr":"-0.18750000", "up":"0", "mt":"iz", "iw":"0", "ps":"SHORT" // SHORT este transmis pe măsură ce este inițializat. } ], "m":"MARGIN_TYPE_CHANGE" } } |