tradingOrdersDocsPage.orderManagement
واجهات إرسال الأوامر وإدارتها API
أنشئ الأوامر وأغلقها وألغها وعدّلها عبر نقاط تداول Finger Trader الموثقة.
نقاط كتابة الأوامر
قد ترسل هذه النقاط أو تغيّر أوامر فعلية. تحقق من الحساب والسوق والأداة والكمية وقواعد الوسيط قبل التجربة.
طلب POST مع Bearer Access Token ومحتوى JSON. يستدعي تطبيق Flutter واجهة Finger Trader 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
يرسل طلب إنشاء أمر جديد.
مثال الطلب
القيم للتوضيح فقط. استبدل 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 العميل | مرجع |
|---|---|---|---|
ticker | string | يقبل null | رموز Ticker / Symbol التي يدعمها الوسيط |
orderType | integer | يقبل null | قيم التداول |
orderSide | integer | يقبل null | قيم التداول |
qty | decimal string | يقبل null | — |
coinType | integer | يقبل null | قيم التداول |
walletType | integer | يقبل null | قيم التداول |
price | decimal string | يقبل null | — |
marginRate | integer | يقبل null | — |
stopLoss | decimal string | يقبل null | — |
takeProfit | decimal string | يقبل null | — |
marketType | integer | يقبل null | الأسواق المدعومة ورموز marketType |
brokerId | integer | يقبل 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
يرسل طلب إغلاق مركز.
مثال الطلب
القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_001",
"qty": "500",
"marketType": 0,
"brokerId": 10001,
"brokerPositionId": "position_demo_001",
"symbol": "EURUSD"
}| المعلمة | النوع | DTO العميل | مرجع |
|---|---|---|---|
userId | string | يقبل null | — |
orderId | string | يقبل null | — |
qty | decimal string | يقبل null | — |
marketType | integer | يقبل null | الأسواق المدعومة ورموز marketType |
brokerId | integer | يقبل null | — |
brokerPositionId | string | يقبل null | — |
symbol | string | يقبل 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
يرسل طلب إلغاء أمر محدد السعر.
مثال الطلب
القيم للتوضيح فقط. استبدل 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 العميل | مرجع |
|---|---|---|---|
userId | string | يقبل null | — |
orderId | string | يقبل null | — |
marketType | integer | يقبل null | الأسواق المدعومة ورموز marketType |
brokerId | integer | يقبل null | — |
brokerOrderId | string | يقبل null | — |
clientOrderId | string | يقبل 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
يرسل طلب تعديل وقف الخسارة أو جني الأرباح.
مثال الطلب
القيم للتوضيح فقط. استبدل 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 العميل | مرجع |
|---|---|---|---|
userId | string | يقبل null | — |
orderId | string | يقبل null | — |
qty | decimal string | يقبل null | — |
price | decimal string | يقبل null | — |
stopLose | decimal string | يقبل null | — |
stopProfit | decimal string | يقبل null | — |
clearStopLoss | boolean | يقبل null | — |
clearTakeProfit | boolean | يقبل 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 الرسمية المختارة بعد الضغط على إرسال الطلب.