marketDataDocsPage.restInstruments
رموز Ticker / Symbol المدعومة
استخدم نقطة ticker-list ذات الصفحات للاستعلام عن رموز Ticker وSymbol التي أعدها الوسيط لهذا الحساب. اختر marketType الذي أعاده API قائمة الأسواق المدعومة.
POST /app-api/v1/market/ticker-list
تعيد نقطة النهاية قائمة مقسمة إلى صفحات. حدد page (يبدأ تطبيق Flutter من 1) وpageSize؛ ويُستخدم query.marketType لتصفية السوق، أما query.brokerId فهو اختياري. تتضمن الاستجابة data.total وdata.items للصفحة المطلوبة. يعتمد الحد الأقصى لحجم الصفحة ونطاق الأدوات على إعداد الوسيط/الخدمة.
POST /app-api/v1/market/ticker-list
{ "page": 1, "pageSize": 20, "query": { "marketType": <marketType from overview>, "brokerId": null } }ticker-list: page, pageSize, query.marketType, query.brokerIdمثال على بنية الاستجابة
يحلل التطبيق غلاف API القياسي وبيانات الصفحة التي تتضمن total وitems. يعرض المثال الحقول المعروفة للعميل؛ وقد تُحذف القيم الفارغة أو الحقول الإضافية.
{
"code": 0,
"data": {
"total": 1,
"items": [
{ "ticker": "<TICKER>", "symbol": "<SYMBOL>", "name": "<DISPLAY_NAME>" }
]
}
}يحدد الوسيط رموز Ticker وSymbol التي يهيئها ويوفرها في كل سوق. لا يستطيع Finger Trader ضمان أن الوسيط يدعم جميع رموز Ticker / Symbol في السوق. تحقق من نطاق الأدوات وتوفرها مع وسيطك.
جرّب طلب REST
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
POST /app-api/v1/market/ticker-list
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.
قد يعني خطأ CORS أو الشبكة أن بيئة API لا تسمح بالطلبات من مصدر هذا الموقع. استخدم عميلاً من جهة الخادم أو أداة API معتمدة، ولا تعطل أمان المتصفح.
POST /app-api/v1/market/ticker-detail
يستعلم عن تفاصيل أداة باستخدام ticker وmarket وbrokerId. ويتضمن نموذج العميل قيم الأسعار ومعلمات التداول عند إعادتها من الخدمة.
POST /app-api/v1/market/ticker-detail
{ "ticker": "<broker-configured ticker>", "market": <marketType from overview>, "brokerId": null }جدول رموز marketType · قائمة الأسواق المدعومة
جرّب طلب REST
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
POST /app-api/v1/market/ticker-detail
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.
قد يعني خطأ CORS أو الشبكة أن بيئة API لا تسمح بالطلبات من مصدر هذا الموقع. استخدم عميلاً من جهة الخادم أو أداة API معتمدة، ولا تعطل أمان المتصفح.
POST /app-api/v1/market/search-ticker
يبحث عن الأدوات باستخدام keyword وpage وpageSize ويحلل التطبيق الاستجابة كقائمة من عناصر Ticker.
POST /app-api/v1/market/search-ticker
{ "keyword": "EURUSD", "page": 1, "pageSize": 20 }جرّب طلب REST
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
POST /app-api/v1/market/search-ticker
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.
قد يعني خطأ CORS أو الشبكة أن بيئة API لا تسمح بالطلبات من مصدر هذا الموقع. استخدم عميلاً من جهة الخادم أو أداة API معتمدة، ولا تعطل أمان المتصفح.
القيم أدناه هي enum باسم marketType معرّف في تطبيق Flutter، وليست قائمة بالأسواق المفعّلة لدى وسيطك. يعتمد الدعم الفعلي على إعداد الحساب والاتصال، لذا اطلب من وسيطك قائمة الأسواق المدعومة. استخدم الرمز المطابق في عوامل تصفية REST وطلبات البيانات التاريخية. أما اشتراكات WebSocket، فابحث أولاً عن ticker الذي أعده الوسيط لذلك السوق ثم اشترك فيه. يساعد ticker-list على معاينة الأدوات المعادة، لكن النتيجة الفارغة وحدها لا تثبت أن السوق غير مدعوم.