Genesis Arbitrage

Genesis Arbitrage · · 2 دقائق قراءة

API

API (واجهة برمجة التطبيقات) مجموعة قواعد يطلب بها برنامج بيانات أو إجراءً من برنامج آخر: أي رابط يُستدعى، وماذا يُرسَل، وبأي صيغة تأتي الاستجابة. يحتاج المتداول إلى API عندما يجب أن يقرأ برنامج الأسعار ودفاتر الأوامر ومعدلات التمويل: بوت أو جدول بيانات أو لوحة متابعة.

مثال طلب

مثال افتراضي: يطلب برنامج من Genesis API ملف عملة IRYS عبر قسم بحث العملات، أي عبر نقطة نهاية (endpoint) واحدة. الطلب HTTP GET، والمفتاح في ترويسة:

curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
  -H "X-API-Key: $GENESIS_API_KEY"

تأتي الاستجابة بصيغة JSON، مع حذف بعض الحقول:

{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true
    }
  }
}

الإنسان يجمع هذه المعلومات من صفحات البورصات ومتصفح البلوكشين، أما البرنامج فيحصل عليها في استجابة واحدة ويحسب فورًا أن عقود MEXC الآجلة أعلى من السوق الفوري بنسبة (0.0133 − 0.01329) / 0.01329 × 100 ≈ 0.075%.

واجهات API العامة والخاصة للبورصات

لواجهة البورصة جزآن. الجزء العام يقدّم بيانات السوق (الأسعار ودفاتر الأوامر والصفقات) دون مفتاح. الجزء الخاص يعمل مع حسابك (الأرصدة والأوامر وسجل الصفقات) ويتطلب مفتاح API وتوقيعًا للطلب. في Binance تحمل نقاط النهاية العامة نوع الأمان NONE، وكل الباقي يتطلب مفتاحًا ومعامل signature.

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

واجهات البيانات: عدة منصات في استجابة واحدة

واجهة البورصة لا تعرف إلا منصتها. ولمقارنة سعر عملة في 20 بورصة يحتاج البرنامج إلى 20 اتصالًا، ولكل بورصة صيغة استجابة وحدود خاصة بها. واجهة البيانات تجمع المنصات مسبقًا.

نوع APIماذا تعيدالوصول
API عام للبورصةأسعار ودفاتر أوامر وصفقات بورصة واحدةبلا مفتاح
API خاص للبورصةالأرصدة والأوامر وعمليات السحبمفتاح وتوقيع
Genesis APIالسبريدات ودفاتر الأوامر والتمويل وDEX وأونتشين وأسواق التنبؤاتمفتاح، قراءة فقط

طلب واحد إلى نقطة النهاية /arbitrage/spot-spot في Genesis API يعيد السبريدات المحسوبة بين الأسواق الفورية في أكثر من 20 بورصة CEX، مع علامات الإيداع والسحب. كل طلب HTTP GET وكل استجابة JSON، ومعاملات كل نقطة نهاية وحقولها في التوثيق.

انظر أيضًا: API العملات الرقمية: الأنواع وكيف تختار، بداية سريعة في التوثيق، حد المعدل، الدرس: ما هو API العملات الرقمية.

أسئلة وأجوبة

هل أحتاج إلى SDK للعمل مع API؟

إذا كان API يعمل عبر HTTP فأي عميل HTTP يكفي. مع Genesis API يكفي curl أو requests في Python أو fetch المدمج في JavaScript.

هل يمكنني التداول عبر Genesis API؟

لا. Genesis API يقدّم البيانات فقط. الأوامر تُنفَّذ في البورصة يدويًا أو عبر API البورصة نفسها بمفتاحها، وعلى مسؤوليتك.