البدء السريع مع 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.

ما الذي تغطيه واجهة API
تعكس نقاط النهاية أقسام الموقع:
- المراجحة — سبوت - سبوت، سبوت - عقود آجلة، عقود آجلة - عقود آجلة، DEX - سبوت، DEX - عقود آجلة، كروس تشين ومراجحة الأسهم.
- دفاتر الأوامر — أسعار التنفيذ لحجم معيّن في كل سوق، و«Order-book Δ» لصفوف المراجحة، ودفتر أوامر السوق، وسجل التنفيذ، وانزلاق DEX (في خطتي API Pro وMax).
- أسواق التنبؤات — مراجحة التنبؤات وحالة المنصات؛ والتحليلات والأموال الذكية والصفقات الكبيرة وترتيب المتداولين في خطتي API Pro وMax.
- التمويل — معدلات التمويل في جميع البورصات، وفرق التمويل، وتحليلات التمويل التاريخية (في خطتي API Pro وMax).
- السوق — Fair - Last، وCEX Pumps - Dumps، وDEX Dumps، وتتبع OI.
- على السلسلة — التحويلات الكبيرة، وتدفقات CEX، والسك والجسور، ومحافظ الفرق، ومراكز Perp. DEX، وفتح التوكنات، والمطالبات، والاختراقات؛ وفي خطتي API Pro وMax أيضًا نظرة عامة على DEX والتحليلات وصفحة العملة.
- الذكاء الاصطناعي والبحث — إشارات Genesis AI+ وبطاقة العملة الكاملة.
- الحساب — حالة مفتاحك: الخطة والحصة المستخدمة والحدود.
توصف مجموعات البيانات في صفحة Genesis API؛ أما معاملات كل نقطة نهاية وحقولها ففي التوثيق.
الخطط والحدود
لواجهة API خططها الخاصة، المنفصلة عن اشتراك الموقع: Trial وStart وPro وMax. تختلف في حصة الاستدعاءات وحد الطلبات في الثانية وحداثة البيانات.
| خطة API | الاستدعاءات شهريًا | حداثة البيانات |
|---|---|---|
| Trial | 500 ألف | 60 ث |
| Start | 2 مليون | 30 ث |
| Pro | 5 ملايين | 10 ث |
| Max | 10 ملايين | 5 ث |
تكلّف Trial 20 $ في الشهر، وتسمح Max بـ 15 طلبًا في الثانية. النقاط التي ليست ضمن خطتك تعيد خطأ 403 برمز plan_restricted. الطلبات الزائدة عن الحدود لا تُحتسب مالياً: انتظر الفترة الجديدة أو رقِّ خطتك. تستهلك الحصة ردود 200 فقط: الأخطاء وردود 304 مجانية. الأسعار والمقارنة الكاملة في صفحة أسعار Genesis API.
أول طلب لك
اختر خطة
في صفحة أسعار Genesis API اختر خطة وفترة وانقر «اشترك الآن». الدفع بالعملات المشفرة، كما في اشتراك الموقع. إذا كانت خطة API أخرى نشطة، فإن دفع خطة جديدة يستبدلها ويُلغى المتبقي — ويحذّرك الموقع أولًا.
احصل على مفتاحك
في ملفك الشخصي، في قسم Genesis API، انقر «الحصول على مفتاح». يظهر مفتاح
gns_live_…في نافذة «مفتاح API الخاص بك» — انقر «نسخ» واحفظه. يظهر مرة واحدة فقط.أرسل طلبًا
أرسل طلب HTTP GET عاديًا ومرّر المفتاح في الترويسة
X-API-Key. الرابط الأساسي هوhttps://api.genesisarbitrage.com/v1. نقطة نهاية جيدة للبداية هي/account/usage— تعرض خطتك والحصة المتبقية.حلّل الاستجابة
تأتي الاستجابة الناجحة في غلاف واحد: مصفوفة
dataوكتلةmeta. إذا حدث خطأ، فراجع جدول الأخطاء أدناه.
مثال بـ curl:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
في التوثيق نموذج «جرّب الطلب»: الصق مفتاحك وانقر «إرسال الطلب» وشاهد استجابة مختصرة في الصفحة نفسها. يُحفظ المفتاح في متصفحك فقط.
صيغة الاستجابة
- يحتوي
dataعلى مصفوفة أو كائن بحسب نقطة النهاية. ويحتويmetaعلى عدد العناصر ووقت آخر تحديث للبيانات وتأخير خطتك بالثواني وخطتك. - القيم الفارغة هي
null. الأوقات بثواني unix. - السبريدات والمعدلات نسب مئوية: 0.92 تعني 0.92%.
- كل معاملات التصفية اختيارية: بدونها تعيد نقطة النهاية مجموعة البيانات كاملة.
الأخطاء والحدود
| الرمز | المعنى |
|---|---|
| 401 | المفتاح غائب أو غير صالح أو ملغى |
| 403 | نقطة النهاية ليست ضمن خطتك |
| 404 | لم يُعثر على نقطة النهاية أو المورد |
| 429 | تجاوز حد الطلبات — راجع ترويستي X-RateLimit وRetry-After |
| 500 | خطأ داخلي، أعد المحاولة لاحقًا |
| 503 | البيانات قيد إعادة البناء، أعد المحاولة بعد ثوانٍ — راجع Retry-After |
تُظهر ترويسات X-RateLimit في كل استجابة حد طلباتك في الثانية وكم طلبًا بقي في النافذة الحالية ومتى تُعاد النافذة. وتُظهر ترويسات X-Quota حصة الاستدعاءات للفترة وما تبقى منها ووقت إعادة تعيينها. وتحمل كل استجابة أيضًا X-Request-Id: عند التواصل مع الدعم أرسله مع وقت الطلب بتوقيت UTC ونقطة النهاية والحالة. لا ترسل المفتاح نفسه أبدًا.
ماذا بعد
- مفتاح API: الحصول عليه وحفظه وإعادة إصداره — أين يوجد المفتاح في ملفك الشخصي وكيف تحميه.
- الحدود: الحصة والطلبات في الثانية والحداثة — كيف تتجنب ردود 429.
- الاستجابات والأخطاء: JSON وETag ورموز HTTP — غلاف الاستجابة ورد 304 وإعادة المحاولة.
- نقاط النهاية حسب المجموعة: المراجحة، دفاتر الأوامر، التمويل، السوق وإشارات الذكاء الاصطناعي، على السلسلة، أسواق التنبؤات والسَّيربِت.
- Genesis API لوكلاء الذكاء الاصطناعي — مواصفة OpenAPI وllms.txt واستدعاء الدوال.
أسئلة وأجوبة
بماذا يختلف Genesis API عن واجهات البورصات المجانية؟
تعيد واجهات البورصات دفاتر الأوامر والأسعار لمنصة واحدة. أما Genesis API فيعيد سبريدات محسوبة عبر عشرات البورصات والشبكات، وأعلام الإيداع والسحب، وبيانات منقّاة من الأزواج غير السائلة.
ماذا يحدث إذا تجاوزت الحد؟
يردّ الخادم بالرمز 429 مع ترويستي X-RateLimit وRetry-After. ولا تُحتسب الطلبات الزائدة مالياً.
هل يمكنني تغيير خطة API؟
نعم. تسري الخطة الجديدة بعد الدفع مباشرة: تُطبَّق الحدود والحداثة الجديدة فورًا، وتُحتسب حصة الاستدعاءات من الصفر، ويُلغى المتبقي من الخطة السابقة. أما تجديد الخطة نفسها فيضيف أيامًا إلى المدة الحالية.
هل يمكنني استخدام البيانات في منتجي الخاص؟
نعم، يمكنك بناء خدماتك وبوتاتك ولوحاتك على Genesis API. لا يجوز إعادة بيع البيانات الخام كما هي.