FINGER TRADER

brokerageDocsPage.orders

واجهات إدارة الأوامر 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 في هذا القسم

Order pool, customer positions and history, grouped history, export, and order action endpoints used by Finger Admin.

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 بعد الانتهاء.

Customer order history

Paged order history for a customer or broker query.

POST/mer-api/v1/order/get-user-order-history-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-history-list

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

الاستجابة
—

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

Grouped customer order history

Paged grouped history query.

POST/mer-api/v1/order/get-user-order-history-grouped-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-history-grouped-list

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

الاستجابة
—

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

Customer order history statistics

Aggregate history statistics using OrderListQueryWithUserDTO.

POST/mer-api/v1/order/get-user-order-history-stat

مثال الطلب

{
  "brokerNumber": "",
  "userName": "",
  "userNumber": "",
  "timezone": "UTC",
  "marketType": 0,
  "orderType": 0,
  "coinType": 0,
  "orderSide": 0,
  "startTime": "",
  "endTime": ""
}

حقول الطلب

brokerNumberstring
userNamestring
userNumberstring
timezonestring
marketTypenumber
orderTypenumber
coinTypenumber
orderSidenumber
startTimestring
endTimestring

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

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

{
  "code": 0,
  "data": {
    "total": 0,
    "buyCount": 0,
    "sellCount": 0
  },
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/order/get-user-order-history-stat

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

الاستجابة
—

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

Broker order history

Paged broker order history query.

POST/mer-api/v1/order/get-broker-order-history-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-broker-order-history-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 بعد الانتهاء.