brokerageDocsPage.orders
واجهات إدارة الأوامر API
واجهات الوسيط للاستعلام عن مراكز العملاء وسجل الأوامر ومجموعات أوامر السوق وتنفيذ الإجراءات المصرح بها.
المصادقة وصلاحيات الوصول
تتطلب هذه الواجهات جلسة موظف وسيط موثقة وصلاحيات backend المناسبة. لا يصادق Token مستخدم تطبيق التداول العادي على هذه الواجهات. تحقق من الصلاحيات مع مسؤول الوسيط.
أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.
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.
/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 بعد الانتهاء.
Customer order history
Paged order history for a customer or broker query.
/mer-api/v1/order/get-user-order-history-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-history-list
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
Grouped customer order history
Paged grouped history query.
/mer-api/v1/order/get-user-order-history-grouped-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-history-grouped-list
جاهز. لن يُرسل الطلب حتى تضغط إرسال.
الاستجابة—
يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.
Customer order history statistics
Aggregate history statistics using OrderListQueryWithUserDTO.
/mer-api/v1/order/get-user-order-history-statمثال الطلب
{
"brokerNumber": "",
"userName": "",
"userNumber": "",
"timezone": "UTC",
"marketType": 0,
"orderType": 0,
"coinType": 0,
"orderSide": 0,
"startTime": "",
"endTime": ""
}حقول الطلب
brokerNumberstringuserNamestringuserNumberstringtimezonestringmarketTypenumberorderTypenumbercoinTypenumberorderSidenumberstartTimestringendTimestringمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل 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.
/mer-api/v1/order/get-broker-order-history-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-broker-order-history-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 بعد الانتهاء.