FINGER TRADER

marketDataDocsPage.wsDepth

عمق السوق عبر WebSocket

اشترك في تحديثات عمق bid/ask عبر مقبس بيانات السوق الموثق. يعتمد الدعم وعدد المستويات على إعداد الوسيط والسوق.

إطار الوثائق · نظرة عامة

الاشتراك في تحديثات العمق: action 3 وmsgType 3. رسائل العمق الواردة تستخدم msgType 2.

يستخدم تطبيق Flutter مقبس السوق المهيأ في Finger Trader. احصل على WebSocket ticket من نقطة النهاية الموثقة ثم اتصل باستخدامه. الـ ticket بيانات اعتماد للجلسة؛ لا تنشره أو تعِد استخدامه.

استدع POST /ws-api/v1/auth/build-ticket في خدمة Socket لدى Finger Trader مع Bearer Token للحساب. يقرأ التطبيق ticket من حقل data في استجابة API القياسية.

{"action":3,"fromUserId":"<SESSION_USER_ID>","timestamp":"<EPOCH_MILLISECONDS>","msgType":3,"msgId":"<UNIQUE_MESSAGE_ID>","content":{"tickerList":["<TICKER>"]}}

تتضمن رسائل الأسعار marketType وticker وtime وchange وpercent وvolume وnumber وhigh وlow وask وbid وopen وclose وquoteVolume. وتتضمن رسائل العمق marketType وticker وtime ومستويات ask وbid. لا يحدد عقد العميل وتيرة الإرسال أو عدد مستويات العمق.

2. اتصل بمقبس الإنتاج · الاشتراك في تحديثات العمق: action 3 وmsgType 3. رسائل العمق الواردة تستخدم msgType 2.

استدع POST /ws-api/v1/auth/build-ticket في خدمة Socket لدى Finger Trader مع Bearer Token للحساب. يقرأ التطبيق ticket من حقل data في استجابة API القياسية.

جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.

ستظهر الاستجابة هنا.

يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.

القيم أدناه هي enum باسم marketType معرّف في تطبيق Flutter، وليست قائمة بالأسواق المفعّلة لدى وسيطك. يعتمد الدعم الفعلي على إعداد الحساب والاتصال، لذا اطلب من وسيطك قائمة الأسواق المدعومة. استخدم الرمز المطابق في عوامل تصفية REST وطلبات البيانات التاريخية. أما اشتراكات WebSocket، فابحث أولاً عن ticker الذي أعده الوسيط لذلك السوق ثم اشترك فيه. يساعد ticker-list على معاينة الأدوات المعادة، لكن النتيجة الفارغة وحدها لا تثبت أن السوق غير مدعوم.