كيفية إنشاء وإعداد مفتاح واجهة API من Bybit

تُستخدم APIs التداول بشكل واسع لمرونتها ومرونتها في التخصيص. يكون دمج API التداول مفيدًا بشكل خاص للأتمتة التي تمكن المتداولين من إدارة محافظهم، تحليل الاتجاهات السوقية أو تنفيذ استراتيجيات تداول متقدمة. مع استمرار تطور سوق العملات المشفرة، يتم دمج المزيد من ترقيات المنتجات والميزات لتلبية الطلب المتزايد، بما في ذلك نشر Bybit APIs. 

في هذا الدليل، ستتعلم كيفية دمج Bybit API مع تطبيقات التداول الآلي الأخرى. 

أهم ما يجب معرفته:

• تعمل واجهات برمجة التطبيقات ومفاتيح API يدًا بيد، مما يسمح لتطبيقات البرامج بالتفاعل مع بعضها البعض.

• تقدم Bybit العديد من واجهات برمجة التطبيقات، بدءًا من WebSocket API وREST API إلى واجهة برمجة سوق البيانات التاريخية.

• يمكن للمستخدمين الاستفادة من هذه الواجهات البرمجية عن طريق تخصيص واجهة المستخدم الخاصة بهم وتفضيلاتهم وأتمتة استراتيجياتهم لتداول النسخ لزيادة سرعة ودقة تداولهم.

ما هي واجهة Bybit البرمجية؟

واجهة Bybit البرمجية هي مجموعة من واجهات برمجة التطبيقات (APIs) التي تسمح للمطورين بالتفاعل برمجيًا مع منصة Bybit. تعتبر Bybit بورصة من الدرجة الأولى لمشتقات العملات الرقمية التي تقدم خيارات تداول لمختلف الأصول الرقمية. مع واجهات برمجة التطبيقات، يمكن للمطورين الوصول إلى بيانات السوق، وإدارة الأوامر، وتنفيذ التداولات والاشتراك في تدفقات البيانات. 

تحتوي واجهة برمجة التطبيقات على عدة نسخ تناسب منتجات وميزات مختلفة. على سبيل المثال، تدعم واجهة V3 التداول الفوري وعقود USDC الدائمة وحقوق الخيارات، بينما تدعم واجهة V2 العقود العكسية الدائمة وعقود المستقبل. لزيادة الأمان إلى الحد الأقصى، تستخدم واجهة Bybit البرمجية تشفير HMAC للمصادقة. يمكن للمطورين استخدام مجموعة من الأدوات واللغات، بما في ذلك Python، Node.js و WebSocket للاندماج مع Bybit API.

فهم API مقابل مفاتيح API 

يشير API إلى بروتوكول اتصال يستخدم مجموعة مختلفة من القواعد واللغات، مما يسمح لتطبيقات البرمجيات بالتفاعل مع بعضها البعض. على سبيل المثال، يستخدم ويب API بروتوكولات HTTP، مما يسمح للمطورين بالوصول إلى الموارد عبر الإنترنت باستخدام تنسيقات بيانات شائعة مثل JSON وXML.

في حين أن مفاتيح API يمكن أن تظهر في شكل مفاتيح عامة أو خاصة. تعمل كمفاتيح مصادقة أو رموز وصول، باستخدام سلسلة من الأحرف الفريدة التي تعمل كشكل من أشكال المصادقة عند طلب الوصول إلى وظيفة API. يتم إنشاء مفاتيح المصادقة هذه من قبل مزود API بشكل أساسي لتتبع استخدام API من قبل عملاء أو تطبيقات مختلفة. 

Bybit V3 مقابل V5 API: أوجه الاختلاف

Bybit V3 API هو الإصدار السابق من API لBybit. يدعم العقود الخطية والعكسية لكل من الحسابات العادية والموحدة. من ناحية أخرى، API Bybit V5 هو أحدث إصدار، تمت ترقيته لدعم العقود الفورية والمشتقات وعقود الخيارات لـ< Bybit Unified Accounts.

إليك بعض الاختلافات بين API V3 و V5:

• API Bybit V3 يغطي فقط منتجات تداول معينة، بينما المنتجات الأخرى لديها مجموعة خاصة من APIs. في المقابل، يقوم API V5 بدمج APIs لمنتجات تداول مختلفة في واحد، مما يسمح للمستخدمين بتداول العقود الفورية والمشتقات والخيارات من خلال API واحد.

• على عكس V3، يسمح API Bybit V5 للمستخدمين بترقية حساباتهم إلى حساب تداول موحد، مما يتيح مشاركة الأموال والاستخدام المتقاطع عبر أنواع العقود المختلفة.

• يدعم API V5 الاقتراض عبر وضع حساب تداول موحد، باستخدام أصول متعددة كضمان للحصول على هامش للتداول عبر منتجات مختلفة.

• كما يمكن API V5 من دمج الهوامش بين عقود USDT Perpetual و USDC Perpetual و USDC Futures والخيارات لحسابات التداول الموحدة.

تم بناء API Bybit V5 على أساس API V3، مما يجعله سهل الترقية للمستخدمين ببساطة عن طريق تعديل عنوان URL وحقول الواجهة.

معرفة المزيد: وثائق API Bybit (وثائق API)

كيفية إنشاء مفتاح API على Bybit

ولاستخدام Bybit مع التطبيقات الخارجية، يجب عليك أولاً إنشاء مفتاح واجهة برمجة التطبيقات (API) على منصة Bybit. ولكن قبل القيام بذلك، من الضروري فهم حد معدل الـ IP.

فهم حد معدل IP

يُعد حد معدل IP آلية لتنظيم حركة مرور الشبكة بناءً على عناوين IP للطلبات الواردة، ويمنع المستخدمين من تكرار الإجراءات بشكل متكرر جدًا في إطار زمني محدد. لدى Bybit حدود معدلات مختلفة للطلبات المختلفة، مثل البيانات العامة، البيانات الخاصة وعمليات الطلب.

إذا تجاوزت حد المعدل لنوع معين من الطلبات، ستتلقى رمز خطأ وسيتم رفض طلبك. لتجنب ذلك، يجب عليك مراقبة تكرار طلباتك وضبطها وفقًا لذلك. بالإضافة إلى ذلك، فكر في استخدام واجهة برمجة التطبيقات WebSocket بدلاً من REST لبعض الطلبات، لأن طلبات WebSocket لا تُحتسب ضد حد المعدل.

إرشادات خطوة بخطوة لربط واجهة برمجة التطبيقات الخاصة بك

لاستخدام واجهة برمجة التطبيقات الخاصة بـ Bybit مع تطبيق أو منصة، قم أولاً بإنشاء مفتاح API على Bybit ثم قم بتوصيله بالمنصة المرغوبة. تابع الخطوات التالية:

1. قم بتسجيل الدخول إلى حساب Bybit الخاص بك أو قم بالتسجيل للحصول على حساب Bybit.

2. انقر على أيقونة الحساب الخاصة بك في الزاوية اليمنى العليا من الشاشة، واختر API من القائمة المنسدلة.

3. انتقل إلى علامة التبويب إدارة API وانقر على إنشاء مفتاح جديد.

4. اختر إما مفاتيح API المولدة من النظام أو مفاتيح API المولدة ذاتيًا.

5. اختر الاتصال بتطبيقات الطرف الثالث، قم باختيار تطبيق الطرف الثالث من القائمة المنسدلة، وقم بتسمية مفتاح API.

6. قم بتعيين الأذونات لمفتاح API (مثل معلومات الحساب، وضع الطلبات، معلومات المراكز) وانقر على إرسال.

7. انسخ مفتاح API والسر، واحفظها في مكان آمن.

8. قم بتسجيل الدخول إلى تطبيق الطرف الثالث وربط الـ API المحفوظ. 

كيفية ربط 3Commas API على Bybit

إذا كنت تريد استخدام منصة تداول العملات الرقمية 3Commas مع Bybit، أولاً، اربطها باستخدام مفتاح API. إليك الخطوات التي تتبعها:

1. سجل الدخول إلى حساب Bybit الخاص بك أو اشترك للحصول على حساب Bybit.

2. انقر على أيقونة حسابك في الزاوية العلوية اليمنى من الشاشة، واختر API من القائمة المنسدلة.

3. انتقل إلى علامة التبويب إدارة API وانقر على إنشاء مفتاح جديد.

4. اختر مفاتيح API المولدة بواسطة النظام.

5. تحول إلى الاتصال بتطبيقات الطرف الثالث، واختر 3Commas من قائمة اختيار اسم التطبيق.

6. اختر الأذونات لمفتاح API: معلومات الحساب، وضع الطلبات، معلومات المراكز، إلخ. (يمكنك أيضًا اختيار قراءة فقط إذا كنت ترغب فقط في عرض بيانات حسابك على 3Commas.)

7. اضغط على إرسال لإنشاء مفتاح API. سترى مفتاح API والمفتاح السري على الشاشة. يمكنك نسخها إلى الحافظة أو تنزيلها كملف.

8. سجل الدخول إلى حساب 3Commas أو قم بإنشاء حساب جديد.

9. اذهب إلى صفحة تبادلاتي واضغط على إضافة تبادل.

10. اختر Bybit من قائمة التبادلات المدعومة، وقم بإدخال مفتاح API والمفتاح السري الذي قمت بإنشائه على Bybit. تحتاج أيضًا إلى إدخال هوية العميل الخاصة بك، والتي يمكنك العثور عليها في صفحة تغيير كلمة المرور على Bybit.

11. انقر على اتصال لربط حسابك في Bybit بـ 3Commas.

بمجرد إكمال هذه الخطوات، يمكنك استخدام 3Commas مع Bybit والوصول إلى مجموعة من أدوات وميزات التداول المختلفة. إذا كنت بحاجة إلى تحديث أو حذف مفتاح API الخاص بك، يمكنك القيام بذلك من صفحة إدارة API على Bybit، أو من صفحة البورصات الخاصة بي على 3Commas.

كيفية ربط Insilico API على Bybit

Insilico هي منصة للتداول بالعملات الرقمية تقدم مجموعة من الأدوات والميزات، مثل الرسوم البيانية التفاعلية، ودفاتر الطلبات، والصفقات، والأدوات، والنشاط، والأوامر، والمراكز، والإعدادات، والتكوين، ولوحات التنفيذ ولوحات الجوانب. 

إليك كيفية ربط حساب Bybit الخاص بك بـ Insilico:

1. سجّل الدخول إلى حسابك في Bybit وانقر على أيقونة الحساب في الزاوية العلوية اليمنى من الشاشة.

2. انقر على أيقونة الحساب الخاصة بك في الزاوية العلوية اليمنى من الشاشة، واختر API من القائمة المنسدلة.

3. انتقل إلى علامة التبويب إدارة API وانقر على إنشاء مفتاح جديد.

4. اختر مفاتيح API التي تم إنشاؤها بواسطة النظام.

5. تغيير إلى الاتصال بالتطبيقات الطرف الثالث واختر Insilico Terminal من القائمة المنسدلة. هذا يضمن أن المفتاح مغلق على نطاق IP الخاصة بخادم Insilico.

6. اختر الأذونات لمفتاح API: معلومات الحساب، وضع الطلبات ومعلومات الموقع. يمكنك أيضاً اختيار قراءة فقط لعرض بيانات الحساب فقط على Insilico.

7. انقر على إرسال لتوليد مفتاح الواجهة البرمجية. سترى كلاً من المفتاح ومفتاح السر على الشاشة. إذا رغبت، يمكنك أيضاً نسخها أو تحميلها كملف.

8. قم بتسجيل الدخول إلى حسابك في Insilico (أو أنشئ حساباً جديداً).

9. اذهب إلى صفحة الإعدادات وانقر على إضافة تبادل.

10. اختر Bybit من قائمة التبادلات المدعومة، وادخل مفاتيح الواجهة البرمجية والمفتاح السري التي تم توليدها على Bybit. تحتاج أيضًا إلى إدخال معرف العميل الخاص بك، والذي يمكنك العثور عليه في تغيير كلمة المرور على صفحة Bybit.

11. انقر على اتصال لربط حساب Bybit الخاص بك بـ Insilico.

هل يمكنني استخدام بيئة اختبار Bybit لاختبار API؟

نعم. يمكنك استخدام بيئة اختبار Bybit لاختبار API طالما تريد، لكن البيانات والمعاملات ليست حقيقية وقد لا تعكس ظروف السوق الفعلية. بيئة اختبار Bybit، والمعروفة أيضًا باسم testnet، هي منصة تداول افتراضية تتيح لك اختبار استراتيجيات API والأكواد الخاصة بك دون المخاطرة بأموال حقيقية. توفر الوصول إلى خدمات Bybit API، مثل REST API، وWebSocket API وبيانات السوق التاريخية.

أنواع Bybit API

يحتوي Bybit API على ثلاثة أنواع من الواجهات. 

واجهة برمجة تطبيقات REST 

REST API هو واجهة تتيح لك إرسال الطلبات واستقبال الاستجابات باستخدام طرق HTTP، مثل GET، وPOST، وPUT، وDELETE. يمكنك استخدام REST API لتنفيذ إجراءات متنوعة على منصة Bybit: استعلام بيانات السوق، وضع أوامر، تعديل أوامر والتحقق من المراكز. REST API مثالي للطلبات ذات التردد المنخفض والكمون العالي.

واجهة برمجة تطبيقات WebSocket

تتيح لك هذه الواجهة إنشاء اتصال مستمر مع خادم Bybit وتلقي التحديثات في الوقت الفعلي باستخدام بروتوكول WebSocket. يمكنك استخدام WebSocket API، المجهز ببيانات WebSocket، للاشتراك في مختلف أسواق المواضيع الخاصة والعامة، مثل دفتر الطلبات، بيانات K-line، الصفقات، معدل التمويل، حالة الطلبات وحالة المراكز. WebSocket API هو الأنسب للطلبات ذات التردد العالي والكمون المنخفض.

استكشف: اشترك في WebSocket API.

بيانات السوق التاريخية

يمكنك تحميل بيانات السوق العامة التاريخية بصيغة CSV واستخدام هذه البيانات لاختبار استراتيجياتك وتحليل اتجاهات السوق. تشمل بيانات السوق التاريخية لقطات لدفتر الطلبات، بيانات K-line، بيانات الصفقات وبيانات معدل التمويل.

معرفة المزيد: قم بتنزيل Bybit Market Data API هنا.

كيف يمكنك الاستفادة من Bybit API؟

Bybit API هو أداة قوية يمكن أن تساعد في تحسين تجربة وأداء التداول الخاص بك. إليك بعض الطرق التي يمكنك الاستفادة منها:

• قم بأتمتة استراتيجيات التداول الخاصة بك بسرعة ودقة. تسمح لك Bybit API بإنشاء وتشغيل روبوتات التداول التي يمكنها وضع وتعديل وإلغاء الأوامر وإدارة المراكز بناءً على منطقك ومعاييرك المحددة مسبقاً. تتيح لك API أيضًا التكامل مع أدوات وميزات التداول الخارجية.

• الوصول إلى بيانات السوق في الوقت الفعلي والتاريخية. اشترك في مواضيع بيانات السوق المختلفة، واستلم التحديثات في الوقت الفعلي باستخدام WebSocket API. يمكنك أيضًا تنزيل بيانات السوق العامة التاريخية بتنسيق CSV لتحليل اتجاهات السوق، وتحديد فرص التداول واختبار استراتيجياتك.

• خصّص واجهة المستخدم والتفضيلات الخاصة بك. قم بإنشاء واجهة المستخدم ولوحة التحكم الخاصة بك لعرض المعلومات والوظائف التي تناسب احتياجاتك. يمكنك ضبط إعداداتك وتكويناتك، مثل وضع الهامش، مستوى الرافعة المالية وحد المخاطرة.

هل واجهة برمجة التطبيقات لـ Bybit مجانية؟

واجهة برمجة التطبيقات لـ Bybit مجانية للاستخدام من قبل مستخدمي Bybit، دون أية رسوم أو تكاليف إضافية. ومع ذلك، لا تزال رسوم التداول والتمويل العادية تنطبق على صفقاتك على المنصة.

الخلاصة

توفر واجهة برمجة التطبيقات لـ Bybit للمطورين أدوات وواجهات مفيدة حتى يمكنهم التفاعل مع منصة Bybit عبر الشيفرة البرمجية. تسمح لك هذه الأدوات بأتمتة استراتيجيات التداول، الوصول إلى بيانات السوق في الوقت الفعلي وتخصيص واجهة المستخدم الخاصة بك. 

اتبع الخطوات المذكورة أعلاه لإعداد مفتاح واجهة برمجة التطبيقات على Bybit وربطه بتطبيقات طرف ثالث مثل 3Commas أو Insilico. من المهم ملاحظة الفروق بين إصدارات API لـ Bybit V3 و V5 والبقاء ضمن حدود معدل IP لتداول سلس.