Genesis Arbitrage

Genesis Arbitrage · · آخر تحديث · 5 دقائق قراءة

البدء السريع مع Genesis API: المفتاح وأول طلب والحدود

باختصار

  • Genesis API وصول REST إلى بيانات Genesis Arbitrage: سبريدات CEX وDEX ودفاتر الأوامر والتمويل وعبر السلاسل وتدفقات السلسلة وأسواق التنبؤات وإشارات Genesis AI+.
  • الوصول إلى أول طلب يتطلب ثلاث خطوات: خطة، ومفتاح في ملفك الشخصي، وطلب GET بالترويسة X-API-Key.
  • تحدد خطتك حصة الاستدعاءات وعدد الطلبات في الثانية وتأخير البيانات — من 60 ثانية في Trial إلى 5 ثوانٍ في Max.

يقدّم Genesis API بيانات Genesis Arbitrage بصيغة REST API: السبريدات بين CEX وDEX، ودفاتر الأوامر، والتمويل، وعبر السلاسل، وتدفقات السلسلة، وأسواق التنبؤات، وإشارات Genesis AI+. كل أداة في الموقع متاحة كنقطة نهاية مستقلة بصيغة JSON واحدة. يحتاج أول طلب إلى خطة API ومفتاح وترويسة HTTP واحدة — لا حاجة إلى SDK، وتكفي أي لغة فيها عميل HTTP.

البدء السريع مع Genesis API: المفتاح وأول طلب والحدود
كما يظهر في Genesis Arbitrage

ما الذي تغطيه واجهة API

تعكس نقاط النهاية أقسام الموقع:

توصف مجموعات البيانات في صفحة Genesis API؛ أما معاملات كل نقطة نهاية وحقولها ففي التوثيق.

الخطط والحدود

لواجهة API خططها الخاصة، المنفصلة عن اشتراك الموقع: Trial وStart وPro وMax. تختلف في حصة الاستدعاءات وحد الطلبات في الثانية وحداثة البيانات.

خطة APIالاستدعاءات شهريًاحداثة البيانات
Trial500 ألف60 ث
Start2 مليون30 ث
Pro5 ملايين10 ث
Max10 ملايين5 ث

تكلّف Trial ‏20 $ في الشهر، وتسمح Max بـ 15 طلبًا في الثانية. النقاط التي ليست ضمن خطتك تعيد خطأ 403 برمز plan_restricted. الطلبات الزائدة عن الحدود لا تُحتسب مالياً: انتظر الفترة الجديدة أو رقِّ خطتك. تستهلك الحصة ردود 200 فقط: الأخطاء وردود 304 مجانية. الأسعار والمقارنة الكاملة في صفحة أسعار Genesis API.

أول طلب لك

  1. اختر خطة

    في صفحة أسعار Genesis API اختر خطة وفترة وانقر «اشترك الآن». الدفع بالعملات المشفرة، كما في اشتراك الموقع. إذا كانت خطة API أخرى نشطة، فإن دفع خطة جديدة يستبدلها ويُلغى المتبقي — ويحذّرك الموقع أولًا.

  2. احصل على مفتاحك

    في ملفك الشخصي، في قسم Genesis API، انقر «الحصول على مفتاح». يظهر مفتاح gns_live_… في نافذة «مفتاح API الخاص بك» — انقر «نسخ» واحفظه. يظهر مرة واحدة فقط.

  3. أرسل طلبًا

    أرسل طلب HTTP GET عاديًا ومرّر المفتاح في الترويسة X-API-Key. الرابط الأساسي هو https://api.genesisarbitrage.com/v1. نقطة نهاية جيدة للبداية هي /account/usage — تعرض خطتك والحصة المتبقية.

  4. حلّل الاستجابة

    تأتي الاستجابة الناجحة في غلاف واحد: مصفوفة data وكتلة meta. إذا حدث خطأ، فراجع جدول الأخطاء أدناه.

مثال بـ curl:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

في التوثيق نموذج «جرّب الطلب»: الصق مفتاحك وانقر «إرسال الطلب» وشاهد استجابة مختصرة في الصفحة نفسها. يُحفظ المفتاح في متصفحك فقط.

صيغة الاستجابة

الأخطاء والحدود

الرمزالمعنى
401المفتاح غائب أو غير صالح أو ملغى
403نقطة النهاية ليست ضمن خطتك
404لم يُعثر على نقطة النهاية أو المورد
429تجاوز حد الطلبات — راجع ترويستي X-RateLimit وRetry-After
500خطأ داخلي، أعد المحاولة لاحقًا
503البيانات قيد إعادة البناء، أعد المحاولة بعد ثوانٍ — راجع Retry-After

تُظهر ترويسات X-RateLimit في كل استجابة حد طلباتك في الثانية وكم طلبًا بقي في النافذة الحالية ومتى تُعاد النافذة. وتُظهر ترويسات X-Quota حصة الاستدعاءات للفترة وما تبقى منها ووقت إعادة تعيينها. وتحمل كل استجابة أيضًا X-Request-Id: عند التواصل مع الدعم أرسله مع وقت الطلب بتوقيت UTC ونقطة النهاية والحالة. لا ترسل المفتاح نفسه أبدًا.

ماذا بعد

أسئلة وأجوبة

بماذا يختلف Genesis API عن واجهات البورصات المجانية؟

تعيد واجهات البورصات دفاتر الأوامر والأسعار لمنصة واحدة. أما Genesis API فيعيد سبريدات محسوبة عبر عشرات البورصات والشبكات، وأعلام الإيداع والسحب، وبيانات منقّاة من الأزواج غير السائلة.

ماذا يحدث إذا تجاوزت الحد؟

يردّ الخادم بالرمز 429 مع ترويستي X-RateLimit وRetry-After. ولا تُحتسب الطلبات الزائدة مالياً.

هل يمكنني تغيير خطة API؟

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

هل يمكنني استخدام البيانات في منتجي الخاص؟

نعم، يمكنك بناء خدماتك وبوتاتك ولوحاتك على Genesis API. لا يجوز إعادة بيع البيانات الخام كما هي.