FINGER TRADER

brokerageDocsPage.riskControl

واجهات إدارة المخاطر API

واجهات وحدة تحكم الوسيط لمراجعة مجموعات أوامر السوق ومراكز العملاء، مع روابط إلى إعدادات التداول.

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

المصادقة وصلاحيات الوصول

تتطلب هذه الواجهات جلسة موظف وسيط موثقة وصلاحيات backend المناسبة. لا يصادق Token مستخدم تطبيق التداول العادي على هذه الواجهات. تحقق من الصلاحيات مع مسؤول الوسيط.

أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.

https://dev-api.fingertrading.com/finger-bff-merchant
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.

POST/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.

POST/mer-api/v1/order/market-data-list

مثال الطلب

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "marketType": 0
  }
}

حقول الطلب

pagenumber
pageSizenumber
queryobject

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

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل 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.

POST/mer-api/v1/order/get-user-order-holding-list

مثال الطلب

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

حقول الطلب

pagenumber
pageSizenumber
queryobject

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

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل 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.

POST/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.

POST/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.

POST/mer-api/v1/trade/user-match-config-set

مثال الطلب

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": {
    "status": 1,
    "orderSide": 0,
    "rate": 1,
    "followOrderFirst": false
  }
}

حقول الطلب

marketTypenumber
userIdstring
valueobject

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

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/trade/user-match-config-set

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

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

الاستجابة
—

يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.