ما هو 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 المنصة: بيانات ووصول إلى الحساب لمنصة واحدة. تقدّم المنصة الأسعار ودفاتر الأوامر والصفقات علنًا، أما الأرصدة والأوامر وسجل الصفقات فتتطلب مفتاحًا وطلبًا موقّعًا. توضح Binance ذلك في أنواع الأمان:
NONEلبيانات السوق المفتوحة، وTRADEلوضع الأوامر وإلغائها، وUSER_DATAلتفاصيل الحساب (توثيق Binance). - API بيانات السوق: منصات وشبكات كثيرة في صيغة واحدة. يقدّم ما يتطلب الجمع بين المنصات: السبريدات بين المنصات، ومعدلات التمويل موحّدة على فترة واحدة، والفائدة المفتوحة حسب المنصة. Genesis API من هذا النوع، ويقرأ البيانات فقط.
- API السلسلة (on-chain): بيانات البلوكتشين مثل المعاملات وتحويلات الرموز وأرصدة العناوين. أما التصنيفات مثل «منصة» أو «فريق المشروع» أو «حوت» فتأتي من خدمات تحليل مبنية فوق بيانات الشبكة.
مقارنة بين ستة أنواع من 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.
ما ستحتاج إليه في بقية الدورة
- مفتاح Genesis API: اختر خطة في صفحة الأسعار واحصل على المفتاح بزر «الحصول على مفتاح» في ملفك الشخصي؛ الخطوات في البداية السريعة مع Genesis API. احفظ المفتاح في متغير البيئة
GENESIS_API_KEYولا تضعه أبدًا في رابط الطلب. - curl لأول طلباتك من الطرفية.
- Python 3.10+ ومكتبة
requests(pip install requests) للسكربتات في الدرسين 2 و4. - توثيق Genesis API: لكل نقطة نهاية معاملاتها وحقولها ومثال curl ونموذج «جرّب الطلب» يرسل الطلب مباشرة من الصفحة.
الدروس يبني بعضها على بعض:
- الدرس 2: أول طلب لك، مع العنوان والترويسات ورموز الحالة وJSON؛
- الدرس 3: أي بيانات تخدم أي قرارات، من السبريدات ودفاتر الأوامر إلى التمويل وتدفقات السلسلة؛
- الدرس 4: مراقب للسبريد والتمويل بلغة Python؛
- الدرس 5: مخاطر الأتمتة، ومنها البيانات القديمة والأخطاء والمفاتيح ووكلاء الذكاء الاصطناعي.
جرّب بنفسك
أرسل طلبًا بلا مفتاح
شغّل
curl "https://api.genesisarbitrage.com/health"في الطرفية. الاستجابة{"ok":true}تعني أن الطلب وصل وأن الخادم ردّ بصيغة JSON.طابق الجدول بالحقول
افتح جدول Spot – Spot وقسم Spot — Spot في التوثيق. ابحث عن حقول المنصات والأسعار والسبريد وحالة التحويل:
exchange_buyوprice_sellوspread_pctوwithdraw_enabled_buy.اكتب مهامك الروتينية
اختر ثلاثة أشياء تفعلها كل يوم وصنّف كلًّا منها بحسب الجدول أعلاه: الموقع أو Genesis API أو API المنصة.
ابحث عن نقطة النهاية لمهمة واحدة
لمهمة من مهام Genesis API، ابحث عن نقطة النهاية في التوثيق ودوّن المعاملات التي تحتاجها، مثل
coinوmin_spread. سترسل هذا الطلب في الدرس 2.