FINGER TRADER

brokerageDocsPage.tradingConfiguration

واجهات إعدادات التداول 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 settings for market matching, trading schedules, margin, fees, interest, and fee records.

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

Set trading time schedule

Updates market trading time slots.

POST/mer-api/v1/trade/set-trading-time-config

مثال الطلب

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": [
    {
      "type": 0,
      "ruleValue": "WEEKDAY",
      "startTime": {
        "hour": 9,
        "minute": 0,
        "second": 0,
        "nano": 0
      },
      "endTime": {
        "hour": 17,
        "minute": 0,
        "second": 0,
        "nano": 0
      },
      "startDate": "2026-01-01",
      "endDate": "2026-12-31",
      "priority": 1
    }
  ]
}

حقول الطلب

marketTypenumber
userIdstring
valueobject

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

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

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

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

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

الاستجابة
—

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

Set margin

Updates margin values for a market.

POST/mer-api/v1/trade/set-margin

مثال الطلب

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": [
    1,
    2
  ]
}

حقول الطلب

marketTypenumber
userIdstring
valueobject

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

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

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

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

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

الاستجابة
—

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

Set open fee

Updates opening fee configuration.

POST/mer-api/v1/trade/set-open-fee

مثال الطلب

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": "0.001"
}

حقول الطلب

marketTypenumber
userIdstring
valuestring

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

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

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

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

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

الاستجابة
—

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

Set close fee

Updates closing fee configuration.

POST/mer-api/v1/trade/set-close-fee

مثال الطلب

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": "0.001"
}

حقول الطلب

marketTypenumber
userIdstring
valuestring

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

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

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

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

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

الاستجابة
—

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

Set broker fee

Updates a broker fee configuration.

POST/mer-api/v1/trade/broker-fee-config-set

مثال الطلب

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": 0.001
}

حقول الطلب

marketTypenumber
userIdstring
valuenumber

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

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

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

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

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

الاستجابة
—

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

Interest configuration list

Queries configured interest by market and ticker.

POST/mer-api/v1/trade/interest-config-list

مثال الطلب

{
  "marketType": 0
}

حقول الطلب

marketTypenumber

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

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

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/trade/interest-config-list

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

الاستجابة
—

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

Set interest configuration

Updates ticker buy/sell interest settings.

POST/mer-api/v1/trade/interest-config-set

مثال الطلب

{
  "ticker": "EURUSD",
  "buy": 0,
  "sell": 0
}

حقول الطلب

tickerstring
buynumber
sellnumber

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

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

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

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

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

الاستجابة
—

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

Fee records

Paged fee record query.

POST/mer-api/v1/trade/fee-records

مثال الطلب

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userId": "demo-user-id",
    "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/trade/fee-records

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

الاستجابة
—

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