FINGER TRADER

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 }

جرّب طلب 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 على معاينة الأدوات المعادة، لكن النتيجة الفارغة وحدها لا تثبت أن السوق غير مدعوم.