سلسلة واجهة برمجة تطبيق Binance - الجزء الأول: التداول الفوري باستخدام Postman
جدول المحتويات
المقدمة
المتطلبات الأساسية
إنشاء بيئة التشغيل
استيراد المجموعة
إجراء الطلبات
تصحيح الأخطاء باستخدام Postman
أفكار ختامية
سلسلة واجهة برمجة تطبيق Binance - الجزء الأول: التداول الفوري باستخدام Postman
الصفحة الرئيسيةالمقالات
سلسلة واجهة برمجة تطبيق Binance - الجزء الأول: التداول الفوري باستخدام Postman

سلسلة واجهة برمجة تطبيق Binance - الجزء الأول: التداول الفوري باستخدام Postman

متقدم
Published Jul 13, 2020Updated Oct 19, 2021
13m


المحتويات


المقدمة

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

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

في هذا المقال، سنستخدم منصة Postman للاتصال بمنصّة التداول. ولا داع للقلق – لن نُعرّض أي أموال حقيقية للخطر.


المتطلبات الأساسية

مفاتيح الشبكة التجريبية

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


  1. ابدأ بالانتقال إلى شبكة التداول الفوري التجريبية.
  2. للدخول إلى الشبكة، يجب أن تسجل الدخول باستخدام حساب GitHub، فإذا لم يكن لديك حساب بالفعل، عليك إنشاء حساب.
  3. انقر على مصادقة وسجّل الدخول عبر GitHub.
  4. تحت مفاتيح واجهة برمجة التطبيق، سيتم إعلامك بعدم وجود مفاتيح مسجلة لديك. انقر على إنشاء مفتاح HMAC_SHA256 لإنشاء زوج من المفاتيح.
  5. في الشاشة التالية، امنح المفتاحين أسماءً، ويمكنك استخدام أي اسم تريد ثم اضغط على إنشاء
  6. سيظهر لك مفتاحان: مفتاح واجهة برمجة التطبيق والمفتاح السريّ. من الضروري أن تسجل هذين المفتاحين الآن، حيث ستضطر إلى بدء عملية إنشاء المفاتيح مرة أخرى إذا لم تسجلهما، لذا نوصي بحفظهما في تطبيق الملاحظات على جهازك لنسخهما ولصقهما بسهولة لاحقاً.
ملحوظة: تسمية مفاتيحك أمر جدير بالاهتمام عند استخدام منصّة التداول الحقيقية من أجل إدارة المفاتيح المختلفة، حيث يمكن أن يكون لحسابك مفاتيح متعددة ذات تصاريح مختلفة. وإذا كنت تُشغّل بوتات تداول متعددة، فإن استخدام مفاتيح منفصلة تحمل أسامي وصفية يسهل عليك إدارة التصاريح أو حذف المفاتيح الفردية دون تغيير كل البوتات الخاصة بك.


تنزيل منصة Postman وتثبيتها

منصة Postman هي منصة تعاونية لواجهات برمجة التطبيقات، وتمثل نقطة بداية مثالية لنا – حيث ستكون لدينا إمكانية الوصول إلى مجموعات من طلبات Binance (بينانس) التي سنختبرها دون الحاجة إلى كتابة سطر كود واحد.

البرنامج متوفر لأنظمة التشغيل Mac، وWindows، وLinux. انتقل إلى صفحة التنزيلات ونزّل الملف المضغوط (zip.).

بمجرد الانتهاء من هذه الخطوة، حدد مكان الملف في مستكشف الملفات على جهازك، وثبّته. شغّل التطبيق، واستعد لبدء العمل! لاحظ أنه يمكنك إنشاء حساب لتسجيل الدخول، لكن هذا ليس ضرورياً، فإذا أردت تجاوز هذه الخطوة، حدد الخيار الذي يتيح لك ذلك الموجود أسفل النافذة.


إنشاء بيئة التشغيل

في هذه المرحلة، من المفترض أن تكون لديك واجهة مشابهة للواجهة التالية.



ينبغي علينا أولاً إنشاء بيئة التشغيل، وهذه مجرد طريقة تتيح لنا إضافة متغيرات إلى مجموعة الطلبات التي سنستخدمها. لتحقيق ذلك، سنحتاج أولاً إلى الحصول على بعض المعلومات من مستودع GitHub الخاص بمنصّة Binance (بينانس). انتقل إلى هنا ونزّل الملف المضغوط (zip.).



من المفترض ألا تستغرق عملية التنزيل وقتاً طويلاً، اعثر على الملف في مستكشف الملفات، وفكّ ضغطه. وبعد ذلك، يمكنك العودة إلى Postman.



انقر على أيقونة الترس في الركن الأيمن العلوي (موضحة في الصورة أعلاه)، وستنبثق أمامك نافذة إدارة البيئات
  1. اختر استيراد، وانتقل إلى المجلد الذي استخرجته للتو (binance-postman-api). 
  2. ادخل إليه، ثم ادخل إلى مجلد البيئات. 
  3. سترى الآن ملفين (أحدهما للشبكة الرئيسية والآخر للشبكة التجريبية)، الملف الذي نريده هو binance_com_spot_testnet_api.postman_environment.json. تأكد من اختيار الملف الصحيح لأن المفاتيح لن تعمل مع الملف الآخر.



أوشكنا على الانتهاء. انقر على واجهة برمجة تطبيق شبكة Binance التجريبية للتداول الفوري، وسترى المتغيرات الموضحة فيما يلي. عدّل المتغيرين المحددين باللون الأحمر في الصورة عن طريق لصق المفتاحين اللذين حفظتهما سابقاً، ثم انقر على تحديث واخرج من النافذة المنبثقة.



في هذه الشاشة، اترك حقلي الطابع الزمني والتوقيع فارغين، حيث سيتم إنشاء هاتين القيمتين تلقائياً مع كل طلب.

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


استيراد المجموعة

الآن سنستورد المجموعة – وهي عبارة عن مجموعة متنوعة وشاملة من الأوامر التي تخفف من على عاتقنا عبئاً ثقيلاً عند تقديم الطلبات. لتحميلها إلى بيئة التشغيل:

  1. انقر على استيراد في الركن الأيسر العلوي.
  2. في النافذة المنبثقة، تحت علامة التبويب ملف، اختر تحميل الملفات.
  3. ابحث مرة ثانية عن مجلد binance-postman-api، حدد مكانه وافتحه.
  4. هذه المرة، ادخل إلى مجموعات في الدليل الفرعي.
  5. ستجد هناك ملفين أيضاً، أحدهما مخصص لاستخدام واجهة برمجة تطبيق العقود الآجلة، لكننا الآن نستخدم واجهة برمجة تطبيق التداول الفوري، لذلك عليك تحديد ملف binance_spot_api_v1.postman_collection.json.
  6. من المفترض أن ترى الآن شاشة تأكيد تشير إلى أن ما تم استيراده بتنسيق مجموعات Postman، اختر استيراد.

تحت علامة تبويب المجموعات على يسار النافذة، ستلاحظ الآن وجود مجلد يحتوي على أكثر من 100 طلب. تهانينا! نحن مستعدون الآن للبدء. في القسم التالي، سنلقي نظرة على أنواع الطلبات التي يمكننا إجراؤها.


إجراء الطلبات

عند الضغط لاستعراض المجلدات تحت علامة تبويب المجموعات، سترى أنه لدينا مجموعة من الطلبات المختلفة التي يمكن إجراؤها. من الترميز بالألوان، ستلاحظ أنه يوجد ثلاثة أنواع من الأساليب التي يمكننا استخدامها:


  • الحصول (GET): يُستخدم الحصول لاسترداد الأشياء من الخادم، وسنستخدم هذا الخيار للتوصل إلى معلومات حول رصيد حسابك، وأسعار الأصول، وغيرها.
  • النشر (POST): سنستخدم النشر بوجه عام لإنشاء المعلومات على الخادم، وهذا أمر مطلوب لإجراءات معينة مثل تقديم الطلبات، وطلب عمليات السحب، وغيرها.
  • الحذف (DELETE): الحذف هو طلب حذف معلومات من الخادم، وتكون مفيدة في إلغاء الطلبات.


العثور على قائمة الرموز وقواعد التداول

حان الوقت لإجراء أول طلب لنا! سوف نحصل على الرموز التي يمكننا تداولها على منصّة التداول وقواعد التداول:

GET /exchangeInfo


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

لتحميل هذا الطلب، اختر السوق > معلومات التداول، وستنبثق علامة تبويب كالموضحة فيما يلي:



لا نحتاج إلى فعل أي شيء آخر هنا، لذا اضغط على إرسال، وستتلقى استجابة:



في القسم المحدد العلوي، سترى بعض المعلومات المهمة:

  • حالة الاستجابة (200 تعني أننا نجحنا، و400-499 تعني أننا واجهنا مشكلة)
  • الوقت المستغرق لتلقي الاستجابة (أقل من ثانية)

  • حجم الاستجابة (~22 كيلوبايت).


في المربع الثاني، يوجد نص الاستجابة بالكامل، وقد تم عرضه بأسلوب تنسيق "برتي برنت" لتسهيل رؤيته بعض الشيء. تحتوي هذه الاستجابة على معلومات حول منصّة التداول نفسها، بالإضافة إلى أزواج التداول التي يمكنك تداولها، والحد الأدنى/الأقصى للمبالغ.

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


التحقق من أرصدة الحسابات

دعونا نتحقق من الأصول التي لدينا وكمياتها:

GET /account
يمكن إيجاد هذا الطلب تحت تداول > معلومات الحساب، انقر عليه، وسترى تصميماً مشابهاً للتصميم السابق. لكنك ستلاحظ وجود متغيرين جديدين هنا، وهما: الطابع الزمني والتوقيع. بالنسبة للتوقيع فهو إجراء أمني، نظراً لأنك تطلب الآن معلومات حساسة، سيثبت التوقيع أنك صاحب الحساب. 
أما الطابع الزمني، فهو يخبر الخادم بوقت إرسال الطلب. فنظراً لأن الشبكات قد تكون غير موثوقة أو تواجه عطلاً، فقد يتلقى الخادم الطلب بعد وقت كبير من تقديمه، فإذا مر وقت أطول من اللازم، سيرفض الخادم الطلب. يمكنك تحديد المدة التي ترغب في انتظارها باستخدام المتغير recvWindow الذي يكون معداً افتراضياً على 5000 مللي ثانية.
تتولى منصة Postman إنشاء هذين الحقلين نيابة عنا، انقر على إرسال، وستتلقى استجابة. تحت الأرصدة، من المفترض أن ترى ستة أصول – BNB، وBTC، وBUSD، وETH، وLTC، وTRX. وسينقسم الرصيد إلى حر ومحجوز، وبما أننا لم نحجز أي شيء بعد، فمن المفترض أن تكون جميع أصولك حرة.

تهانينا على ثروتك الجديدة (الوهمية)!


كيفية الحصول على السعر الحالي لأحد الرموز

يمكنك محاولة الحصول على السعر الحالي لأحد الأصول بطرق مختلفة، ولعل أبسطها هي الطلب التالي:

GET /api/v3/ticker/24hr
كما هو متوقع، سيمنحك هذا الطلب معلومات حول أسعار الأصول في الأربع وعشرين ساعة الماضية، وستجده في السوق > إحصائيات تغير سعر رمز التداول خلال 24 ساعة. وزوج التداول الافتراضي الذي يظهر لنا كمتغير للرمز هو BTCUSDT
يمكنك إرسال هذا الطلب مباشرةً لترى تفصيلاً لمعلومات السعر. ويمكنك أيضاً تغيير الرمز (إلى BNBBUSD، أو LTCUSDT، أو غير ذلك) أو يمكنك إلغاء تحديد المتغير للحصول على بيانات 40 زوجاً من أزواج التداول.
هناك أيضاً طلب أبسط (السوق > رمز تداول سعر الرمز) والذي يعرض السعر الحالي الذي يتم تداول الأصل به:
GET /api/v3/price

كما هو الحال مع الطلب السابق، يمكنك تغيير متغير الرمز أو حذفه تماماً، والحصول على أحدث سعر لكل الرموز.


التحقق من طول قائمة الطلبات الحالية

طول قائمة الطلبات (يُشار إليه أيضاً بعمق السوق أو DOM) يمكن أن يخبرنا بالكثير من المعلومات عن السوق. سنقوم بإجراء طلب يوفر لنا بعض المعلومات المفيدة:

GET api/v3/depth

عندما نرسل هذا الطلب باستخدام القيم الافتراضية (السوق > قائمة الطلبات)، سنحصل على استجابة توضح لنا العروض وتطلب BTCUSDT. لن يقدم خادم الشبكة التجريبية نفس القدر من البيانات الذي يقدمه خادم الشبكة الفعلية، لذا فيما يلي نوضح لقطة شاشة لما يمكن أن تتوقع رؤيته في البيئة الحقيقية:



في القسم المحدد أعلاه، يمكنك رؤية العرض الأول. وبما أننا نبحث عن BTCUSDT في قائمة الطلبات، فالرقم الموجود بالأعلى هو السعر الذي يرغب أحد الأشخاص في دفعه مقابل عملات BTC الخاصة بك، ويوجد تحته المبلغ الذي يرغب في شرائه. ومن ثم، فإن الأرقام الموجودة على الشاشة توضح أن هذا طلب للحصول على 0.999 BTC بسعر 9704.65 USDT لكل BTC. وإذا واصلنا التمرير لأسفل، فسنلاحظ أن سعر العرض يقل – يمثل ذلك المشترين الذين يرغبون في دفع سعر أقل. 

بطبيعة الحال، سيكون العرض الأعلى هو الأكثر جاذبية، إذا كنت تبحث عن قيمة أكبر مقابل أموالك. غير أنه إذا كنت تحاول بيع 3 BTC مثلاً في السوق، فلن تتمكن سوى من بيع 0.999 BTC مقابل أعلى سعر، وسيكون عليك قبول العروض اللاحقة (الأقل سعراً) حتى يُنفَذ طلبك بالكامل.



استمر في التمرير لأسفل وسترى الطلبات الأخرى، وهي، من الناحية الوظيفية، تشبه العروض فيما عدا أنها تمثّل طلبات لبيع BTC مقابل USDT. 


تقديم طلب تجريبي

سننشر الآن طلباً تجريبياً.

POST api/v3/order/test
على الرغم من أننا نستخدم أموال الشبكة التجريبية، فلن يقدّم ذلك طلباً فعلياً، غير أنه سيكون مفيداً في اختبار الطلبات قبل إرسالها بالفعل. وستجد هذا الطلب تحت تداول > طلب جديد تجريبي (تداول).



يمكنك ملاحظة أن لدينا عدداً أكبر من المتغيرات في هذا الطلب، وسوف نستعرض فيما يلي المتغيرات المحددة منها:


  • الرمز – لقد تناولنا هذا المتغير من قبل، فهذا هو زوج التداول الذي ترغب في تداوله.
  • الجانب – هنا تحدد ما إذا كنت ترغب في الشراء أم البيع. في حالة زوج التداول BTCUSDT، يشير الشراء إلى أنك ترغب في شراء BTC مقابل USDT، في حين يدل خيار البيع على أنك ستبيع BTC مقابل USDT.
  • النوع – نوع الطلب الذي ترغب في إرساله. القيم الممكنة (موضحة بالتفصيل هنا):
    • الطلب الحديّ
    • طلب السوق
    • طلب إيقاف الخسارة
    • طلب إيقاف الخسارة الحديّ
    • طلب جني الأرباح
    • طلب جني الأرباح الحديّ
    • طلب صانع السوق الحديّ
  • زمن النفاذ– يعبّر هذا المتغير عن الكيفية التي ترغب في تنفيذ الطلب بها:
    • GTC (مناسب حتى الإلغاء) – الطلب المناسب حتى الإلغاء (GTC)، الذي ربما يكون الإعداد الأكثر شيوعاً، سيضمن لك أن يكون طلبك صالحاً حتى يُنفَّذ أو حتى تلغيه.
    • FOK (التنفيذ الكامل أو الإنهاء) – يوجّه طلب التنفيذ الكامل أو الإنهاء (FOK) منصّة التداول إلى تنفيذ الطلب كله مرة واحدة. وإذا كانت المنصّة لا يمكنها فعل ذلك، فسيُلغَى الطلب في الحال.
    • IOC (التنفيذ الفوري أو الإلغاء) – يجب تنفيذ كل الطلب أو جزء منه على الفور، وإلا سيُلغَى. وعلى عكس طلب التنفيذ الكامل أو الإلغاء (FOK)، لا يُلغَى الطلب إذا كان من الممكن تنفيذه جزئياً.
  • الكمية – هي ببساطة كمية الأصل الذي ترغب في شرائه أو بيعه.
  • السعر – السعر الذي تريد البيع به، في حالة زوج التداول BTCUSDT، يُعبَّر عن ذلك بعملة USDT.
  • مُعرّف طلب العميل الجديد (newClientOrderId) – عبارة عن مُعرّف للطلب. وهذا ليس حقلاً إجبارياً، ولكن بإمكانك استخدام مُعرّف يجعل من السهل عليك الاستعلام لاحقاً، وإلا فإن منصّة التداول ستقوم بملء هذا الحق عشوائياً.
حسناً! دعونا ننشئ طلباً تجريبياً الآن. سوف نستخدم القيم التي تم إنشاؤها آلياً: طلب حديّ لبيع 0.1 BTC مقابل USD بسعر 9000 دولار. اضغط على إرسال. إذا نجح ذلك، فستحصل على استجابة في صورة علامة {}

 

تقديم طلب فعلي

حان الوقت لتقديم طلب فعلي زائف. 

POST /api/v3/order
انتقل إلى تداول > طلب جديد. لقد أصبحت الآن على دراية بالطلبات التجريبية، ومن ثم لن تكون المتغيرات الموجودة هنا جديدة بالنسبة لك. سنترك كل القيم كما هي، لكن بما أننا مستثمرون متفائلون، سنغيّر السعر الذي نبيع به إلى 40000 دولار. عدّل قيمة السعر لتعكس ذلك، ثم اضغط على إرسال.

ستعرض الاستجابة التي ستحصل عليها مجموعة من التفاصيل حول الطلب في حال نجاحه. 


التحقق من حالة طلب مفتوح

في القسم السابق، تلقينا تأكيداً على تقديم الطلب لكن ماذا إذا أردنا التحقق منه مجدداً لاحقاً؟ لدينا بعض الطلبات التي يمكننا استخدامها.

GET /api/v3/openOrders
ستجد هذا الطلب في تداول > الطلبات المفتوحة الحالية (بيانات_المستخدم). الخيار الافتراضي هنا هو BTCUSDT. إذا ضغطت على إرسال، فسترى كل طلبات BTCUSDT المفتوحة الخاصة بك (حتى الآن، من المفترض أن ترى الطلب الذي أعددناه سابقاً فقط). ويمكنك اختيار عدم تحديد رمز، مما سيؤدي إلى عرض كل طلباتك المفتوحة بدلاً من ذلك.
GET /api/v3/allOrders
من خلال تداول > كل الطلبات (بيانات_المستخدم)، ستحصل على نظرة عامة على كل الطلبات – وليس المفتوح منها فقط. وهنا، يجب أن تقدّم رمزاً، وهناك مجموعة متغيرات اختيارية هي: مُعرّف الطلب (orderId)، ووقت البدء (startTime)، ووقت الانتهاء (endTime)، والحدّ (Limit)، يمكن أن تساعدك في تحسين بحثك، لكننا لن نستخدمها هنا، لذا قم بإلغاء تحديدها جميعاً. اضغط على إرسال، وسترى نفس الاستجابة التي رأيتها في السابق. وإذا كان لديك أي طلبات مغلقة أو ملغاة، فستراها هنا أيضاً. 


وأخيراً، يمكنك الاستعلام عن طلبات محددة عن طريق:

GET /api/v3/order
ستجد هذا تحت تداول > الاستعلام عن طلب (بيانات_المستخدم). ستحتاج إلى تقديم إما مُعرّف الطلب (orderId) وإما مُعرّف طلب العميل الأصلي (origClientOrderId) (علامة "مُعرّف طلب العميل الجديد (newClientOrderId)" الاختيارية التي يمكنك إضافتها للطلبات). ألغ تحديد مُعرّف الطلب. فيما يخص مُعرّف طلب العميل الأصلي، سنقدّم العلامة الافتراضية التي استخدمناها سابقًا – ”my_order_id_1”. املأ هذا الحقل واضغط على إرسال للحصول على الاستجابة.


إلغاء الطلب

بعد فترة من الوقت، ربما نرى أن مبلغ 40000 دولار المستهدف ينم عن تفاؤل مبالغ فيه، فنرغب في إلغائه، في هذه الحالة، سنستخدم:

DELETE /api/v3/order
تحت تداول > إلغاء طلب يوجد طلب سيسمح لنا باختيار طلبات لإلغائها. ألغ تحديد مُعرّف الطلب (orderId) ومُعرّف طلب العميل الجديد (newClientOrderId) واستخدم “my_order_id_1” كقيمة لمُعرّف طلب العميل الأصلي (origClientOrderId).
عندما ترسل هذا الطلب، سيعود إليك طلبك، وإذا مررت لأسفل وصولاً إلى "الحالة"، فسترى أنه قد تم إلغاؤه بالفعل. لتأكيد ذلك، استخدم نقطة نهاية GET /api/v3/openOrders مرة أخرى (وستحصل على قائمة فارغة) أو GET /api/v3/order باستخدام مُعرّف طلب العميل الأصلي (origClientOrderId).


تقديم طلب يُنفَذ في الحال

لم يُنفَذ طلبنا السابق لأنه كان طلباً حدياً لن يُنفَذ إلا عندما يصل سعر BTC إلى 40000 دولار. أما في حالة طلب السوق، فما نوجه إليه المنصّة هو "الشراء/البيع بأي سعر يجري تداول الأصل به حالياً"، وهذا سيُنفَذ في الحال.
لنفعل ذلك، علينا الانتقال مجدداً إلى تداول > طلب جديد. سنعرض نوع الاستجابة (نوع استجابة الطلب الجديد (newOrderRespType))، وهو متغير يمكن تعديله حسب الاستجابة التي نرغب في الحصول عليها من الخادم. وتوجد ثلاثة خيارات هنا: إقرار (ACK)، أو نتيجة (RESULT)، أو FULL (تنفيذ كامل) – يمكنك الاطلاع على أمثلة لكل استجابة هنا. سوف نختار إقرار (ACK)، والذي سيمنحنا إقراراً بسيطاً بأن الطلب قد تم تلقيه.

فيما يلي، يمكنك أن ترى أننا على وشك إرسال طلب سوق لبيع BNB مقابل BUSD بسعر السوق الحالي.



لاحظ أن الاستجابة تمنحنا قدراً ضئيلاً من المعلومات:



يمكنك التحقق من أن الطلب قد تم تنفيذه باستخدام نقطة النهاية /api/v3/allOrders.


التحقق من عمليات التداول الخاصة بك

في النهاية، دعونا نلقِ نظرة على نقطة النهاية الخاصة بالتحقق من عمليات التداول الخاصة بك:

GET /api/v3/myTrades
يوجد هذا الطلب أسفل تداول > قائمة عمليات التداول في الحساب (بيانات_المستخدم)، ويتيح لك التحقق من كل عملية تداول لرمز معين. إذا أردت رؤية كل عمليات التداول الخاصة بك للرمز الافتراضي (BTCUSDT)، فكل ما عليك فعله هو إلغاء تحديد وقت البدء (startTime)، ووقت الانتهاء (endTime)، ومن المُعرّف (fromId). ستعرض الاستجابة ما يصل إلى 500 عملية تداول – يمكنك ببساطة تعديل الحد إذا أردت رؤية المزيد.


تصحيح الأخطاء باستخدام Postman

في منصة Postman، يمكنك أيضاً الكشف عن طلب واستجابة HTTP الأوليين.



هذه القائمة ستفتح وحدة تحكم Postman، التي تطبع تفاصيل كل طلب.



أفكار ختامية

كان الغرض من هذا الدليل هو تعريفك على واجهة برمجة تطبيق Binance بأسلوب سلس وبسيط دون كتابة سطر كود واحد. وإذا تابعت ما تناولناه، فسيكون لديك الآن فكرة عن كيفية طلب المعلومات وإرسالها.

في الأجزاء التالية من هذه السلسلة، سنقدم بعض مفاهيم كتابة الأكواد الأساسية التي ستتيح لنا تحويل عملية شراء وبيع العملات الرقمية وغيرها من الأصول الرقمية إلى عملية آلية. 
هل لديك أسئلة حالياً؟ يمكن التوجه إلى منتدى مجتمع مطوري Binance (بينانس) أو الاطلاع على مجموعة الوثائق.