FINGER TRADER

tradingOrdersDocsPage.orders

واجهات استعلام الأوامر API

استخدم واجهات التداول الموثقة للاستعلام عن المراكز المفتوحة وسجل التداول والأوامر المكتملة والإحصاءات.

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

نقاط استعلام الأوامر

تستخدم طلبات القوائم page وpageSize وكائن query متداخلاً. تتضمن الاستجابة items وبيانات الصفحات. تعتمد عوامل التصفية والسجلات المتاحة على إعداد الوسيط والخدمة.

يتطلب نموذج PageQuery في العميل page وpageSize، ويمكن أن تكون عوامل تصفية query فارغة. يعتمد الحد الأقصى لحجم الصفحة وسلوك المؤشر على إعداد الخدمة.

طلب POST مع Bearer Access Token ومحتوى JSON. يستدعي تطبيق Flutter واجهة Finger Trader App BFF الموثقة. البدء: المصادقة

عنوان Base URL لـ 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

POST

يعيد صفحة المراكز المفتوحة للحساب.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
pageintegerمطلوب في نموذج العميل—
pageSizeintegerمطلوب في نموذج العميل—
queryobjectمطلوب في نموذج العميل—
query.nextCursorstring | nullيقبل null—
query.brokerIdinteger | nullيقبل null—
query.walletTypeinteger | nullيقبل nullقيم التداول
query.marketTypeinteger | nullيقبل nullالأسواق المدعومة ورموز marketType
query.orderTypeinteger | nullيقبل nullقيم التداول
query.coinTypeinteger | nullيقبل nullقيم التداول
query.orderSideinteger | nullيقبل nullقيم التداول
query.startTimeinteger | nullيقبل null—
query.endTimeinteger | 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

POST

يعيد صفحة سجل التداول للحساب.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
pageintegerمطلوب في نموذج العميل—
pageSizeintegerمطلوب في نموذج العميل—
queryobjectمطلوب في نموذج العميل—
query.nextCursorstring | nullيقبل null—
query.brokerIdinteger | nullيقبل null—
query.walletTypeinteger | nullيقبل nullقيم التداول
query.marketTypeinteger | nullيقبل nullالأسواق المدعومة ورموز marketType
query.orderTypeinteger | nullيقبل nullقيم التداول
query.coinTypeinteger | nullيقبل nullقيم التداول
query.orderSideinteger | nullيقبل nullقيم التداول
query.startTimeinteger | nullيقبل null—
query.endTimeinteger | 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

POST

يعيد صفحة الأوامر المكتملة للحساب.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
pageintegerمطلوب في نموذج العميل—
pageSizeintegerمطلوب في نموذج العميل—
queryobjectمطلوب في نموذج العميل—
query.nextCursorstring | nullيقبل null—
query.brokerIdinteger | nullيقبل null—
query.walletTypeinteger | nullيقبل nullقيم التداول
query.marketTypeinteger | nullيقبل nullالأسواق المدعومة ورموز marketType
query.orderTypeinteger | nullيقبل nullقيم التداول
query.coinTypeinteger | nullيقبل nullقيم التداول
query.orderSideinteger | nullيقبل nullقيم التداول
query.startTimeinteger | nullيقبل null—
query.endTimeinteger | 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

POST

يعيد كائن إحصاءات سجل التداول.

مثال الطلب

القيم للتوضيح فقط. استبدل ticker والسوق ومعرّفات الحساب/الأمر والوسيط بالقيم الخاصة بحسابك، وتحقق من الحقول المطلوبة مع وسيطك قبل الإرسال.

{
  "walletType": 2,
  "marketType": 0,
  "orderType": 1,
  "coinType": 0,
  "orderSide": 1,
  "startTime": 1735689600000,
  "endTime": 1735776000000
}
معلمات الطلب
المعلمةالنوعDTO العميلمرجع
query.nextCursorstring | nullيقبل null—
query.brokerIdinteger | nullيقبل null—
query.walletTypeinteger | nullيقبل nullقيم التداول
query.marketTypeinteger | nullيقبل nullالأسواق المدعومة ورموز marketType
query.orderTypeinteger | nullيقبل nullقيم التداول
query.coinTypeinteger | nullيقبل nullقيم التداول
query.orderSideinteger | nullيقبل nullقيم التداول
query.startTimeinteger | nullيقبل null—
query.endTimeinteger | 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 الرسمية المختارة بعد الضغط على إرسال الطلب.