تحديثات مراكز API وتدفق سعر Mark Price
ملخص
تعلن Propr عن تغيير في بيانات المراكز لمطوري API: أحداث position.* تعمل فقط عند تغيير الحالة، مع إضافة تدفق mark.updated عالمي. يجب على المطورين تخزين الحالة وإعادة حساب PnL غير المحقق والمقاييس الأخرى من جانب العميل باستخدام وظائف TypeScript و Python المنشورة.
@Builders
تغيير مهم لمطوري API: تحديثات المراكز + تدفق جديد لسعر Mark Price
لقد قمنا بتغيير كيفية تدفق بيانات المراكز المباشرة عبر WebSocket. إذا كنت تستهلك أحداث position.* أو تعرض PnL/equity/liq/drawdown مباشرة، فهذا يؤثر عليك. يرجى القراءة قبل النشر القادم.
ما الذي تغير
لم نعد ندفع تحديثاً كاملاً للمركز مع كل حركة في السوق. كان ذلك يستهلك الكثير من الموارد ولا يتوافق مع طريقة عمل البورصات. لقد انتقلنا إلى النمط القياسي:
-
أحداث مراكز شبه منتظمة. position.opened / position.updated / position.closed تعمل الآن عند تغيير الحالة (التنفيذ، تغييرات الهامش، الإغلاق) — وليس مع كل حركة سعر. قم بتخزين الحقول التي تحملها.
-
تدفق جديد وموثوق لسعر mark price. mark.updated هو تدفق عالمي (بدون userId) يحمل سعر mark الداخلي الموثوق لكل أصل تحرك، مجمع بتردد ~4Hz. يتم اشتقاق كل ما يعتمد على السعر من جانب العميل من هذا التدفق بالإضافة إلى حالة المركز/الحساب المخزنة لديك.
ما تقوم بحسابه الآن بنفسك (أو عبر أداة بناء)
PnL غير المحقق، القيمة الاسمية، ROE، حقوق الملكية، المحفظة المتقاطعة، نسبة الهامش، سعر التصفية المعزول والمتقاطع، السحب المستخدم، الخسارة اليومية المستخدمة، نسبة هدف الربح، وسعر الاختراق. هذه وظائف نقية تعتمد على آخر سعر mark + حالتك المخزنة. ننشر الوظائف الدقيقة التي تستخدمها واجهة المستخدم الخاصة بنا (TypeScript و Python) في الوثائق، لكي تتطابق أرقامك مع التطبيق لحظة بلحظة.
النمط
-
قم بتخزين الحالة من الأحداث، position.opened/.updated (entryPrice, quantity, positionSide, leverage, marginMode, marginUsed, exchange, asset)، account.updated (balance, isolatedPositionMargin, highWaterMark)، وإعدادات التحدي/التمويل + المقاييس اليومية مرة واحدة عبر REST.
-
مع كل mark.updated، قم بتحديث أسعار mark الخاصة بك وأعد الحساب. اعرض النتائج.
-
لا تزال Propr تجري عمليات التحقق الفعلية من التصفية والاختراق من جانب الخادم، قيمك المحلية مخصصة للعرض فقط.
