brokerageDocsPage.riskControl
واجهات إدارة المخاطر API
واجهات وحدة تحكم الوسيط لمراجعة مجموعات أوامر السوق ومراكز العملاء، مع روابط إلى إعدادات التداول.
المصادقة وصلاحيات الوصول
تتطلب هذه الواجهات جلسة موظف وسيط موثقة وصلاحيات backend المناسبة. لا يصادق Token مستخدم تطبيق التداول العادي على هذه الواجهات. تحقق من الصلاحيات مع مسؤول الوسيط.
أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
واجهات API في هذا القسم
Broker-side risk workflows combine customer order and position queries with controls configured under Trading configuration.
Market order pool
Queries the market order pool using MarketQueryDTO.
/mer-api/v1/order/market-order-listمثال الطلب
{
"marketType": 0
}حقول الطلب
marketTypenumberمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}جرّب هذا الطلب · /mer-api/v1/order/market-order-list
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
Market ticker/order data
Paged market data list; TickerListQueryDTO filters by marketType.
/mer-api/v1/order/market-data-listمثال الطلب
{
"page": 1,
"pageSize": 20,
"query": {
"marketType": 0
}
}حقول الطلب
pagenumberpageSizenumberqueryobjectمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}جرّب هذا الطلب · /mer-api/v1/order/market-data-list
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
Customer open positions
Paged customer holdings query.
/mer-api/v1/order/get-user-order-holding-listمثال الطلب
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}حقول الطلب
pagenumberpageSizenumberqueryobjectمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}جرّب هذا الطلب · /mer-api/v1/order/get-user-order-holding-list
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
Close order
Closes the order identified by IDDTO.
/mer-api/v1/order/close-orderمثال الطلب
{
"id": "demo-record-id"
}حقول الطلب
idstringمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
{
"code": 0,
"data": true,
"msg": "success"
}جرّب هذا الطلب · /mer-api/v1/order/close-order
تغيّر نقطة النهاية هذه بيانات الوسيط أو حالة الأمر. يرسل Try طلباً فعلياً وليس محاكاة. استخدم حساباً وبيئة اختبار معتمدين فقط.
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
User matching configuration
Reads the matching configuration for a market/user context.
/mer-api/v1/trade/user-match-configمثال الطلب
{
"marketType": 0
}حقول الطلب
marketTypenumberمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
{
"code": 0,
"data": {
"id": "sample-id",
"status": 1
},
"msg": "success"
}جرّب هذا الطلب · /mer-api/v1/trade/user-match-config
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
Set user matching configuration
Updates the user matching configuration.
/mer-api/v1/trade/user-match-config-setمثال الطلب
{
"marketType": 0,
"userId": "demo-user-id",
"value": {
"status": 1,
"orderSide": 0,
"rate": 1,
"followOrderFirst": false
}
}حقول الطلب
marketTypenumberuserIdstringvalueobjectمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
{
"code": 0,
"data": true,
"msg": "success"
}جرّب هذا الطلب · /mer-api/v1/trade/user-match-config-set
تغيّر نقطة النهاية هذه بيانات الوسيط أو حالة الأمر. يرسل Try طلباً فعلياً وليس محاكاة. استخدم حساباً وبيئة اختبار معتمدين فقط.
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.