FINGER TRADER

marketDataDocsPage.restHistorical

بيانات السوق التاريخية عبر REST

استخدم نقطة REST K-line لطلب بيانات الشموع التاريخية. يحدد رمز market في جسم الطلب السوق؛ وتعتمد الفواصل والنطاقات على إعداد السوق والوسيط.

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

POST /app-api/v1/market/kline-list

يطلب بيانات الشموع باستخدام market وticker وinterval وstartTime وlimit. تعتمد الفواصل والنطاقات ومدة الاحتفاظ على إعداد الخدمة؛ يرجى التأكد منها مع الوسيط قبل استخدامها.

POST /app-api/v1/market/kline-list
{ "market": <marketType from overview>, "ticker": "<broker-supported ticker>", "interval": "<broker-supported interval>", "startTime": null, "limit": 100 }

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

جرّب طلب REST

أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.

POST /app-api/v1/market/kline-list

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

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

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

قد يعني خطأ CORS أو الشبكة أن بيئة API لا تسمح بالطلبات من مصدر هذا الموقع. استخدم عميلاً من جهة الخادم أو أداة API معتمدة، ولا تعطل أمان المتصفح.

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