Genesis Arbitrage

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

ما هو API العملات الرقمية وما الذي يمكن أتمتته

باختصار

  • API العملات الرقمية واجهة برمجية يستخدمها برنامجك لطلب بيانات السوق والحصول على استجابة بصيغة JSON: السبريد نفسه الذي تراه في جدول الموقع، يصل في الحقول exchange_buy وexchange_sell وspread_pct.
  • API المنصة يغطي بيانات منصة واحدة وحسابها، وAPI بيانات السوق يجمع منصات كثيرة في صيغة واحدة، وAPI السلسلة يقرأ البلوكتشين. Genesis API هو API لبيانات السوق للقراءة فقط.
  • بالـ API يؤتمت المتداولون مراقبة السبريد ومعدل التمويل والفائدة المفتوحة، والتنبيهات، وسجل الإشارات، ولوحات المتابعة، والبحث في البيانات التاريخية.
  • بلا خبرة، أبقِ تنفيذ الصفقات والسحب يدويًا: لقطات البيانات تتأخر عن المنصة، والخطأ في كودك يتكرر مع كل دورة.

API العملات الرقمية واجهة برمجية يستخدمها كودك لطلب بيانات سوق العملات الرقمية والحصول على إجابة يمكنه العمل بها: الأسعار، والسبريدات بين المنصات، ومعدلات التمويل، والفائدة المفتوحة. يقرأ الإنسان هذه الأرقام في جدول، أما البرنامج فيستلمها حقولًا بصيغة JSON ويستطيع مقارنتها بحد معيّن أو تسجيلها أو إرسال تنبيه فورًا. التعريف العام في مدخل القاموس API.

الطلب والاستجابة

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

curl "https://api.genesisarbitrage.com/health"
{"ok":true}

curl برنامج سطر أوامر لطلبات HTTP؛ والأمر curl --version يبيّن هل هو مثبّت. طلبات البيانات تحتاج إلى مفتاح API، وهو سلسلة يتعرّف بها الخادم على حسابك وخطتك. مثال توضيحي: أزواج Spot – Spot لعملة FUEL، والمفتاح مأخوذ من متغير البيئة GENESIS_API_KEY:

URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
  "success": true,
  "data": [
    {
      "coin": "FUEL",
      "exchange_buy": "ByBit",
      "exchange_sell": "Gate",
      "price_buy": 0.0007029,
      "price_sell": 0.0007037,
      "spread_pct": 0.11,
      "withdraw_enabled_buy": true,
      "deposit_enabled_sell": true,
      …
    }
  ],
  "meta": {
    "count": 1,
    "updated_at": 1794675861,
    "freshness_sec": 60,
    "plan": "trial"
  }
}

تحتوي الاستجابة على زوج واحد: شراء FUEL على ByBit بسعر 0.0007029 وبيعها على Gate بسعر 0.0007037. السبريد محسوب مسبقًا في spread_pct: (0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%. تبيّن العلامتان withdraw_enabled_buy وdeposit_enabled_sell أن السحب من ByBit والإيداع إلى Gate مفتوحان، ويخبرك meta.updated_at بوقت بناء اللقطة. جدول Spot – Spot يعرض الأرقام نفسها، وكل حقل موصوف في قسم Spot — Spot من التوثيق.

يتكوّن عنوان الطلب من رابط أساسي ومسار نقطة نهاية (endpoint) ومعاملات، بينما يُرسَل المفتاح منفصلًا في ترويسة X-API-Key. يفصّل الدرس 2 كل جزء من الطلب، ويشرح رموز الحالة وقراءة JSON، ويبيّن كيف تضبط متغير المفتاح.

يسمى هذا النوع من التبادل، طلب تتبعه استجابة بلقطة من البيانات، REST API. تحصل على بيانات جديدة بإرسال الطلب مرة أخرى: يحدّث Genesis API مخرجاته كل meta.freshness_sec ثانية، من 60 في Trial إلى 5 في Max. وتقدّم المنصات قناة ثانية هي WebSocket: يبقى الاتصال مفتوحًا ويدفع الخادم الصفقات وتغيّرات دفتر الأوامر لحظة حدوثها، كما في تدفقات Binance. ليس في Genesis API قناة WebSocket.

أنواع API العملات الرقمية

تختلف واجهات API العملات الرقمية في مصدر البيانات وفيما يمكنك فعله عبرها:

مقارنة بين ستة أنواع من API، وبين REST وWebSocket، وقائمة اختيار من تسع نقاط، في المقال أنواع API العملات الرقمية وكيف تختار منها.

ما الذي يمكن للمتداول أتمتته

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

المهمةما يفعله البرنامجبيانات Genesis API
مراقبة السبريدالأزواج فوق الحد مع إيداع وسحب مفتوحين/arbitrage/spot-spot، /arbitrage/spot-futures
معدل التمويليقارن معدلات المنصات الموحّدة على 8 ساعات/funding/rates، /funding/spread
الفائدة المفتوحةيلتقط تغيّرات OI الحادة خلال 5 دقائق إلى ساعة/market/open-interest
التنبيهاتيراسلك في Telegram عند تحقق شرطأي نقطة نهاية للبيانات
السجليحفظ كل زوج يجده مع الوقتالاستجابة وmeta.updated_at
لوحة المتابعةتعرض أعمدتك وحدودك في صفحتكطلبات من خادمك
البحث التاريخييبحث عن أنماط في بيانات سابقة/funding/analytics/daily (Pro وMax)

التنبيهات مشروع أول شائع: يستطلع البرنامج نقطة نهاية بما لا يزيد عن مرة كل meta.freshness_sec ويراسلك عندما يتجاوز سبريد أو معدل حدّك. وبلا كود تأتي إشارات مماثلة من تنبيهات Telegram في Genesis Arbitrage على خطة Pro في الموقع.

يختبر السجل فكرة قبل أن يكون أي مال على المحك. مثال توضيحي: بوت يسجّل كل 30 ثانية الأزواج التي سبريدها 1% أو أكثر، أي 86,400 / 30 = 2,880 لقطة في اليوم. تبيّن اللقطات كم زوجًا دام أكثر من دقيقة وكم زوجًا اختفى عند الاستطلاع التالي.

للبيانات التاريخية يقدّم Genesis API تحليلات التمويل، حتى سنة من مجاميع التمويل اليومية المسوّاة عبر 13 منصة، وسجل الانزلاق في دفتر الأوامر؛ وكلاهما في خطتي Pro وMax. ليس في Genesis API شموع تاريخية: تقدّمها API المنصات، وعلى Binance عبر GET /api/v3/klines حتى 1,000 شمعة في الطلب الواحد (توثيق Binance). يبني برنامجك بنفسه تاريخ السبريدات بين المنصات من اللقطات في سجله.

ما لا يُؤتمت دون خبرة

عمليتان مكلفتان إذا حدث فيهما خطأ: تنفيذ الصفقات والسحب.

تنفيذ الصفقات

البوت الذي يضع أوامر عبر API التداول في المنصة يخطئ بقدر ما يعمل: خطأ في شرط الدخول مع استطلاع كل 10 ثوانٍ يولّد 3,600 / 10 = 360 أمرًا في الساعة. والبيانات متأخرة أيضًا: تتحدّث لقطة Genesis API كل 60 إلى 5 ثوانٍ بحسب الخطة، وتتأخر دفاتر الأوامر عن المنصة بمقدار 5–20 ثانية، وقد يُغلق السبريد في هذه المدة. Genesis API لا يضع أوامر: يجد الأزواج، وتفتح أنت الصفقة على المنصة بنفسك.

السحب

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

الموقع أم API المنصات أم Genesis API

المهمةالأنسبالسبب
تصفح الأزواج والرسوم البيانيةموقع Genesis Arbitrageجداول ومرشحات بلا كود
إشارات بلا برمجةتنبيهات Telegram في الموقعحدود تُضبط في الواجهة
قواعدك الخاصة عبر 20+ منصةGenesis APIسبريدات محسوبة وصيغة واحدة
الأوامر والأرصدة والسحبAPI المنصةالمنصة وحدها تقبل الأوامر
كل صفقة لحظيًاWebSocket المنصةGenesis API يقدّم لقطات كل 60–5 ث
الشموع السابقةAPI المنصةليس في Genesis API شموع
تاريخ التمويل عبر 13 منصةGenesis API، خطتا Pro وMaxحتى سنة من المجاميع اليومية بصيغة واحدة

إعداد عملي للبدء: يجد Genesis API زوجًا، ويرسل بوتك تنبيهًا، وتفحص أنت دفتر أوامر المنصة وتفتح الصفقة بنفسك. تبدأ خطط Genesis API من Trial بـ 20 $ شهريًا (500K استدعاء، وحداثة 60 ث) إلى Max بـ 200 $ (10M استدعاء، و5 ث)، ولا توجد خطة مجانية. قارن بينها في صفحة أسعار Genesis API.

ما ستحتاج إليه في بقية الدورة

الدروس يبني بعضها على بعض:

جرّب بنفسك

  1. أرسل طلبًا بلا مفتاح

    شغّل curl "https://api.genesisarbitrage.com/health" في الطرفية. الاستجابة {"ok":true} تعني أن الطلب وصل وأن الخادم ردّ بصيغة JSON.

  2. طابق الجدول بالحقول

    افتح جدول Spot – Spot وقسم Spot — Spot في التوثيق. ابحث عن حقول المنصات والأسعار والسبريد وحالة التحويل: exchange_buy وprice_sell وspread_pct وwithdraw_enabled_buy.

  3. اكتب مهامك الروتينية

    اختر ثلاثة أشياء تفعلها كل يوم وصنّف كلًّا منها بحسب الجدول أعلاه: الموقع أو Genesis API أو API المنصة.

  4. ابحث عن نقطة النهاية لمهمة واحدة

    لمهمة من مهام Genesis API، ابحث عن نقطة النهاية في التوثيق ودوّن المعاملات التي تحتاجها، مثل coin وmin_spread. سترسل هذا الطلب في الدرس 2.