tradingOrdersDocsPage.orders
واجهات استعلام الأوامر API
استخدم واجهات التداول الموثقة للاستعلام عن المراكز المفتوحة وسجل التداول والأوامر المكتملة والإحصاءات.
نقاط استعلام الأوامر
تستخدم طلبات القوائم page وpageSize وكائن query متداخلاً. تتضمن الاستجابة items وبيانات الصفحات. تعتمد عوامل التصفية والسجلات المتاحة على إعداد الوسيط والخدمة.
يتطلب نموذج PageQuery في العميل page وpageSize، ويمكن أن تكون عوامل تصفية query فارغة. يعتمد الحد الأقصى لحجم الصفحة وسلوك المؤشر على إعداد الخدمة.
طلب 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/get-holding-orders
يعيد صفحة المراكز المفتوحة للحساب.
مثال الطلب
القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| المعلمة | النوع | DTO العميل | مرجع |
|---|---|---|---|
page | integer | مطلوب في نموذج العميل | — |
pageSize | integer | مطلوب في نموذج العميل | — |
query | object | مطلوب في نموذج العميل | — |
query.nextCursor | string | null | يقبل null | — |
query.brokerId | integer | null | يقبل null | — |
query.walletType | integer | null | يقبل null | قيم التداول |
query.marketType | integer | null | يقبل null | الأسواق المدعومة ورموز marketType |
query.orderType | integer | null | يقبل null | قيم التداول |
query.coinType | integer | null | يقبل null | قيم التداول |
query.orderSide | integer | null | يقبل null | قيم التداول |
query.startTime | integer | null | يقبل null | — |
query.endTime | integer | null | يقبل null | — |
يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.
مثال الاستجابة
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data نتيجة صفحات تتضمن total وitems وpage وpageSize وnextCursor. قد تحتوي عناصر الأمر على قيم فارغة وحقول خاصة بالوسيط.
جرّب طلب REST · /app-api/v1/order/get-holding-orders
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.
سجل التداول
POST /app-api/v1/order/trade-history
يعيد صفحة سجل التداول للحساب.
مثال الطلب
القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| المعلمة | النوع | DTO العميل | مرجع |
|---|---|---|---|
page | integer | مطلوب في نموذج العميل | — |
pageSize | integer | مطلوب في نموذج العميل | — |
query | object | مطلوب في نموذج العميل | — |
query.nextCursor | string | null | يقبل null | — |
query.brokerId | integer | null | يقبل null | — |
query.walletType | integer | null | يقبل null | قيم التداول |
query.marketType | integer | null | يقبل null | الأسواق المدعومة ورموز marketType |
query.orderType | integer | null | يقبل null | قيم التداول |
query.coinType | integer | null | يقبل null | قيم التداول |
query.orderSide | integer | null | يقبل null | قيم التداول |
query.startTime | integer | null | يقبل null | — |
query.endTime | integer | null | يقبل null | — |
يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.
مثال الاستجابة
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data نتيجة صفحات تتضمن total وitems وpage وpageSize وnextCursor. قد تحتوي عناصر الأمر على قيم فارغة وحقول خاصة بالوسيط.
جرّب طلب REST · /app-api/v1/order/trade-history
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.
الأوامر المكتملة
POST /app-api/v1/order/completed-orders
يعيد صفحة الأوامر المكتملة للحساب.
مثال الطلب
القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| المعلمة | النوع | DTO العميل | مرجع |
|---|---|---|---|
page | integer | مطلوب في نموذج العميل | — |
pageSize | integer | مطلوب في نموذج العميل | — |
query | object | مطلوب في نموذج العميل | — |
query.nextCursor | string | null | يقبل null | — |
query.brokerId | integer | null | يقبل null | — |
query.walletType | integer | null | يقبل null | قيم التداول |
query.marketType | integer | null | يقبل null | الأسواق المدعومة ورموز marketType |
query.orderType | integer | null | يقبل null | قيم التداول |
query.coinType | integer | null | يقبل null | قيم التداول |
query.orderSide | integer | null | يقبل null | قيم التداول |
query.startTime | integer | null | يقبل null | — |
query.endTime | integer | null | يقبل null | — |
يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.
مثال الاستجابة
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data نتيجة صفحات تتضمن total وitems وpage وpageSize وnextCursor. قد تحتوي عناصر الأمر على قيم فارغة وحقول خاصة بالوسيط.
جرّب طلب REST · /app-api/v1/order/completed-orders
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.
إحصاءات سجل التداول
POST /app-api/v1/order/trade-history-stat
يعيد كائن إحصاءات سجل التداول.
مثال الطلب
القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.
{
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}| المعلمة | النوع | DTO العميل | مرجع |
|---|---|---|---|
query.nextCursor | string | null | يقبل null | — |
query.brokerId | integer | null | يقبل null | — |
query.walletType | integer | null | يقبل null | قيم التداول |
query.marketType | integer | null | يقبل null | الأسواق المدعومة ورموز marketType |
query.orderType | integer | null | يقبل null | قيم التداول |
query.coinType | integer | null | يقبل null | قيم التداول |
query.orderSide | integer | null | يقبل null | قيم التداول |
query.startTime | integer | null | يقبل null | — |
query.endTime | integer | null | يقبل null | — |
يحوّل Flutter client startTime وendTime إلى Unix timestamp بتوقيت UTC وبالملي ثانية.
يعني ذلك أن Flutter DTO يسمح بـ null أو حذف بعض المعرفات الاختيارية؛ ولا يؤكد قواعد التحقق على الخادم. تحقق من الحقول المطلوبة مع الوسيط/الخدمة.
مثال الاستجابة
{"code":0,"data":{"totalProfile":"<decimal>"},"msg":""}تتضمن data قيمة totalProfile عند إعادتها من الخدمة.
جرّب طلب REST · /app-api/v1/order/trade-history-stat
أدخل Access Token وعدّل معلمات الطلب. عند الإرسال، يرسل المتصفح الطلب مباشرة إلى بيئة BFF الرسمية المحددة من Finger Trader.
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.
يبقى Access Token في ذاكرة الصفحة فقط، ولا يُحفظ في تخزين المتصفح أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا إلى بيئة API الرسمية المختارة بعد الضغط على إرسال الطلب.