الدليل السريع للمستخدمين الذين لديهم مساعدين برمجة AI.

 

لمحة عامة

يعد هذا المستند مجموعة من مهارات واجهة برمجة تطبيقات API BingX المخصصة لمساعدي البرمجة في الذكاء الاصطناعي، وهو يتضمن 15 وحدة مهارية تغطي العقود الآجلة الدائمة، التداول الفوري، العقود الآجلة القياسية بهامش العملة، نسخ التداول، وإدارة الحساب.

بعد التثبيت، يمكنك التفاعل مباشرة بلغة طبيعية مع AI للاستعلام عن بيانات السوق، وتنفيذ الصفقات، وإدارة الحسابات، دون الحاجة لكتابة أي كود لطلبات API يدوياً.

مساعدو AI المدعومون: Claude Code،Cursorوغيرهما من مساعدي البرمجة AI الذين يدعمون آلية المهارات.

 

تثبيت

  • التثبيت العام (Claude Code/ Cursor / أخرى)
npx skills add BingX-API/api-ai-skills
  • Claude Code تثبيت مخصص (يدعم التحديثات التلقائية)
/plugin add BingX-API/api-ai-skills

للحصول على تعليمات تثبيت مفصلة، راجع README.md

 

لمحة على المهارات

  • العقود الآجلة الدائمة بهامش USDT
اسم المهارة الغرض يتطلب تصريحاً
bingx-swap-market بيانات السوق: السعر، العمق، الشموع اليابانية، معدل التمويل، الفائدة المفتوحة، إلخ.         غير مكتمل
bingx-swap-trade عمليات التداول: فتح الطلبات، إلغاء الطلبات، ضبط الرافعة المالية، وضع الأصول، إلخ.          نعم
bingx-swap-account معلومات الحساب: الأرصدة، المراكز الحالية، معدلات الرسوم، تدفقات الأموال، إلخ.          نعم
  • تداول فوري
اسم المهارة الغرض يتطلب تصريحاً
bingx-spot-market بيانات السوق: السعر، العمق، الشموع اليابانية،سجل التداول، إلخ.  غير مكتمل
bingx-spot-trade عمليات التداول: فتح الطلبات، إلغاء الطلبات، الاستعلام عن الطلبات، الطلبات OCO، إلخ..  نعم
حساب التداول الفوري BingX معلومات الحساب: الأرصدة، لمحة على الأصول، تحويل الأصول، إلخ.        نعم
محفظة التداول الفوري BingX عمليات المحفظة: الإيداع، السحب، سجلات التحويل، إلخ.       نعم
  • العقود الآجلة الدائمة بهامش العملة
اسم المهارة الغرض يتطلب تصريحاً
سوق العقود الآجلة بهامش العملة BingX بيانات السوق: السعر، العمق، الشموع اليابانية، معدل التمويل، إلخ. غير مكتمل
تداول العقود الآجلة بهامش العملة BingX عمليات التداول: فتح الطلبات، إلغاء الطلبات، الرافعة المالية، وضع الأصول، إلخ. نعم
  • نسخ التداول
اسم المهارة الغرض يتطلب تصريحاً
bingx-copytrade-spot نسخ التداول الفوري: إغلاق صفقات النسخ، الاستعلام عن الأرباح، إلخ.      نعم
bingx-copytrade-swap نسخ تداول العقود الآجلة: إغلاق المراكز، ضبط جني الأرباح/وقف الخسارة، ضبط العمولة، إلخ.              نعم
  • إدارة الحساب
اسم المهارة الغرض يتطلب تصريحاً
bingx-fund-account حساب التمويل: الاستعلام عن الرصيد، نظرة عامة على الأصول، التحويل الداخلي، إلخ.           نعم
bingx-sub-account إدارة الحسابات الفرعية: إنشاء/تجميد الحسابات الفرعية،وإدارة مفاتيح API، إلخ.  نعم
bingx-agent الشريك/الوسيط: دعوة المستخدمين، الاستعلام عن العمولات، والتحقق من بيانات الشريك، إلخ.  نعم
  • العقود الآجلة القياسية
اسم المهارة الغرض يتطلب تصريحاً
bingx-standard-trade العقود الآجلة القياسية: الاستعلام عن المركز، سجل الطلبات، الرصيد، إلخ.             نعم

 

شرح التفويض

  • المهارات التي لا تتطلب تفويضاً

مهارات بيانات السوق التاليةيمكن استخدامها دون تهيئة مفتاح API :

  1. bingx-swap-market (بيانات سوق العقود الآجلة الدائمة)
  2. bingx-spot-market (بيانات سوق التداول الفوري)
  3. bingx-coinm-market (بيانات سوق العقود الآجلة القياسية بهامش العملة)
  • المهارات التي تتطلب تفويضاً

تتطلب جميع مهارات التداول والإدارة المتعلقة بالحساب الأخرى تهيئة متغيرات البيئة التالية:

  1. BINGX_API_KEY — مفتاح API الخاص بك
  2. BINGX_SECRET_KEY — مفتاح السر الخاص بك

API Key يتم إنشاءBingX مركز المستخدم← إدارةAPI .

  • بيئات التشغيل
البيئة الوصف رابط URLالأساس
prod-live الإنتاج (مباشر) https://open-api.bingx.com
prod-vst تجريبية (لا تتطلب أموالاً حقيقية)         https://open-api-vst.bingx.com

للحصول على التفاصيل الفنية الكاملة حول توقيع المصادقة، راجع skills/references/authentication.md

 

آلية الأمان

  • تأكيد عمليات الكتابة

في بيئة prod-live (الإنتاج)، تتطلب جميع عمليات الكتابة (وضع الطلبات، إلغاء الطلبات، التحويلات، إلخ) إدخال المستخدم لكلمة CONFIRMقبل التنفيذ. لا يتطلب الأمر أي تأكيد في البيئة التجريبية.

  • قناع المفاتيح

سيقوم AI بإخفاء المفاتيح تلقائياً عند عرضها:

  1. مفتاح API: يعرض أول 5 وآخر 4 أحرف، على سبيل المثال: su1Qc...8akf
  2. مفتاح السر: مخفي بالكامل، ولا تظهر سوى آخر 5 أحرف فقط، على سبيل المثال: ‎*...aws1**

 

سيناريوهات الاستخدام الشائعة

بمجرد اكتمال التثبيت، يمكنك التفاعل مباشرة معAIباستخدام اللغة الطبيعية. إليك بعض الأمثلة الشائعة:

  • الاستعلام عن بيانات السوق
استعلم عن السعر الحالي لزوج BTC-USDT
عرض بيانات تشارت K-line لآخر ساعة لزوج ETH-USDT
ما هو معدل التمويل الحالي لزوج BTC-USDT؟
  • عمليات التداول
وضع طلب شراء بسعر السوق لزوج BTC-USDT بكمية 0.01
وضع طلب بيع بسعر محدد لـ ETH عند سعر 4,000 USDT وبكمية 0.1
إلغاء كافة الطلبات المفتوحة لزوج BTC-USDT
  • إدارة الحساب
عرض رصيد حساب العقود الآجلة والمراكز الحالية
استعلم عن رصيد حسابي الفوري
تحويل 100 USDT من حسابي الفوري إلى حساب العقود الآجلة
  • عمليات أخرى
عرض قائمة الحسابات الفرعية الخاصة بي
استعلم عن قائمة إحالات الشركاء الخاصة بي

 

سير العمل متعدد المهارات

يمكن دمج مهارات متعددة لإتمام عمليات تداول كاملة:

  • سير عمل تداول العقود الآجلة
swap-market (عرض بيانات سوق وعمق تداول BTC-USDT)
↓
العمق↓swap-account (التحقق من رصيد الحساب والهامش المتاح)
↓
swap-trade (وضع طلب)
  • سير عمل إدارة المراكز
swap-account (عرض المراكز الحالية والأرباح والخسائر PnL)
   ↓
swap-market (عرض آخر سعر)
   ↓
swap-trade (إغلاق أو تعديل المركز)
   ↓
swap-account (تأكيد نتيجة الإغلاق)
  • سير عمل التداول الفوري
spot-market (الاستعلام عن السعر الفوري وعمق السوق)
   ↓
spot-account (التحقق من رصيد الحساب الفوري)
   ↓
spot-trade (تنفيذ طلب بيع أو شراء)
  • تحويل الأصول بين الحسابات
spot-account (عرض الرصيد الفوري)
   ↓
spot-account / fund-account (تحويل الأصول إلى حساب العقود الآجلة)
   ↓
swap-trade (تداول العقود الآجلة باستخدام الأموال المحولة)

 

هيكل الملفات

تتكون كل وحدة مهارة من ملفين:

          skills/<skill-name>/
├── SKILL.md # وصف استخدام العميل
└── api-reference.md # توثيق API الكامل
  1. SKILL.md: يحدد غرض المهارة، وجدول المراجع السريعة، وعينات برمجية بلغة TypeScript، وقواعد تفاعل العميل (المصادقة، وآلية التأكيد، وما إلى ذلك)
  2. api-reference.md: التوثيق الكامل لنقاط اتصال واجهة برمجة التطبيقات API، بما في ذلك تفاصيل المعايير، وحقول الاستجابة، وأمثلة JSON، وأكواد الخطأ

يمكن العثور على وثائق المراجع العامة في المسارskills/references/:

  1. authentication.md — تنفيذ توقيع HMAC SHA256
  2. base-urls.md — إعدادات الرابط الأساسي Base URL للبيئة