FINGER TRADER

tradingOrdersDocsPage.orderManagement

واجهات إرسال الأوامر وإدارتها API

أنشئ الأوامر وأغلقها وألغها وعدّلها عبر نقاط تداول Finger Trader الموثقة.

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

نقاط كتابة الأوامر

قد ترسل هذه النقاط أو تغيّر أوامر فعلية. تحقق من الحساب والسوق والأداة والكمية وقواعد الوسيط قبل التجربة.

طلب POST مع Bearer Access Token ومحتوى JSON. يستدعي تطبيق Flutter واجهة Finger Trader App BFF الموثقة. البدء: المصادقة

عنوان Base URL لـ App BFF للإنتاجhttps://prod-api.fingertrader.com/finger-bff-appترويسة المصادقةAuthorization: Bearer <ACCESS_TOKEN>

يلزم تفعيل حساب Finger Trader وفتح حساب لدى وسيط ضمن منظومة Finger. استخدم Bearer Access Token الموضح في دليل البدء.

تستخدم الاستجابات الناجحة الغلاف القياسي في Finger Trader: code وdata وmsg. يوضح مثال كل نقطة نهاية بنية data التي يحللها تطبيق Flutter.

إنشاء أمر

POST /app-api/v1/order/create-order

POST

يرسل طلب إنشاء أمر جديد.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "ticker": "EURUSD",
  "orderType": 1,
  "orderSide": 1,
  "qty": "1000",
  "coinType": 0,
  "walletType": 2,
  "price": "1.08500",
  "marginRate": 10,
  "stopLoss": "1.07500",
  "takeProfit": "1.09500",
  "marketType": 0
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
tickerstringيقبل nullرموز Ticker / Symbol التي يدعمها الوسيط
orderTypeintegerيقبل nullقيم التداول
orderSideintegerيقبل nullقيم التداول
qtydecimal stringيقبل null—
coinTypeintegerيقبل nullقيم التداول
walletTypeintegerيقبل nullقيم التداول
pricedecimal stringيقبل null—
marginRateintegerيقبل null—
stopLossdecimal stringيقبل null—
takeProfitdecimal stringيقبل null—
marketTypeintegerيقبل nullالأسواق المدعومة ورموز marketType
brokerIdintegerيقبل null—

يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.

مثال الاستجابة

{"code":0,"data":true,"msg":""}

يتوقع العميل أن تكون data نتيجة منطقية.

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

جرّب طلب REST · /app-api/v1/order/create-order

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

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

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

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

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

إغلاق أمر

POST /app-api/v1/order/close-order

POST

يرسل طلب إغلاق مركز.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_001",
  "qty": "500",
  "marketType": 0,
  "brokerId": 10001,
  "brokerPositionId": "position_demo_001",
  "symbol": "EURUSD"
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
userIdstringيقبل null—
orderIdstringيقبل null—
qtydecimal stringيقبل null—
marketTypeintegerيقبل nullالأسواق المدعومة ورموز marketType
brokerIdintegerيقبل null—
brokerPositionIdstringيقبل null—
symbolstringيقبل nullرموز Ticker / Symbol التي يدعمها الوسيط

يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.

مثال الاستجابة

{"code":0,"data":true,"msg":""}

يتوقع العميل أن تكون data نتيجة منطقية.

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

جرّب طلب REST · /app-api/v1/order/close-order

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

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

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

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

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

إلغاء أمر محدد السعر

POST /app-api/v1/order/cancel-order

POST

يرسل طلب إلغاء أمر محدد السعر.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_002",
  "marketType": 0,
  "brokerId": 10001,
  "brokerOrderId": "broker_order_demo_002",
  "clientOrderId": "client_order_demo_002"
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
userIdstringيقبل null—
orderIdstringيقبل null—
marketTypeintegerيقبل nullالأسواق المدعومة ورموز marketType
brokerIdintegerيقبل null—
brokerOrderIdstringيقبل null—
clientOrderIdstringيقبل null—

يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.

مثال الاستجابة

{"code":0,"data":true,"msg":""}

يتوقع العميل أن تكون data نتيجة منطقية.

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

جرّب طلب REST · /app-api/v1/order/cancel-order

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

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

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

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

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

تعديل وقف الخسارة / جني الأرباح

POST /app-api/v1/order/modify-stop-profit-loss

POST

يرسل طلب تعديل وقف الخسارة أو جني الأرباح.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_003",
  "qty": "1000",
  "price": "1.08600",
  "stopLose": "1.07600",
  "stopProfit": "1.09600",
  "clearStopLoss": false,
  "clearTakeProfit": false
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
userIdstringيقبل null—
orderIdstringيقبل null—
qtydecimal stringيقبل null—
pricedecimal stringيقبل null—
stopLosedecimal stringيقبل null—
stopProfitdecimal stringيقبل null—
clearStopLossbooleanيقبل null—
clearTakeProfitbooleanيقبل null—

يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.

مثال الاستجابة

{"code":0,"data":true,"msg":""}

يتوقع العميل أن تكون data نتيجة منطقية.

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

جرّب طلب REST · /app-api/v1/order/modify-stop-profit-loss

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

يرسل Try طلباً فعلياً إلى البيئة المحددة وقد ينشئ أمراً أو يغلقه أو يلغيه أو يعدله. استخدم حساباً تجريبياً وبيئة اختبار معتمدة من الوسيط.

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

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

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