FINGER TRADER

marketDataDocsPage.wsQuotes

الأسعار المباشرة عبر WebSocket

اشترك في تحديثات الأسعار عبر مقبس بيانات السوق الموثق. اختر أدوات السوق واشترك باستخدام معرفات ticker.

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

الأسعار المباشرة وعمق السوق عبر WebSocket

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

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

POST https://prod-api.fingertrader.com/finger-bff-socket/ws-api/v1/auth/build-ticket
Authorization: Bearer <ACCESS_TOKEN>

wss://prod-api.fingertrader.com/finger-bff-socket/ws?ticket=<WS_TICKET>

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

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

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

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

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

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

{"action":3,"fromUserId":"<SESSION_USER_ID>","timestamp":"<EPOCH_MILLISECONDS>","msgType":1,"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. لا يحدد عقد العميل وتيرة الإرسال أو عدد مستويات العمق.

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