Genesis Arbitrage

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

بيانات API للمراجحة: الفروق ودفاتر الأوامر والتمويل

باختصار

  • لكل سؤال يطرحه المتداول نقطة نهاية خاصة به: فرق السعر هو spread_pct في /arbitrage/*، وتحويل العملة هو علما الإيداع والسحب مع network وcontract، والتنفيذ بحجمك في /orderbooks/*، وحالة التمويل في /funding/*.
  • سبريد الصف يُحسب من آخر الصفقات. في المثال التوضيحي ينكمش 1.5% على 2,500 دولار إلى 0.72% بعد المرور على دفاتر الأوامر، وإلى نحو 0.52% أي قرابة 13 دولارًا بعد رسمي taker بنسبة 0.1% لكل منهما.
  • كل استجابة تحمل توقيتها: meta.updated_at وقت بناء اللقطة، وmeta.freshness_sec خطوة التحديث في خطتك، وage_sec وstale يبيّنان عمر دفتر الأوامر.
  • يُفحص الزوج على أربع نقاط: فرق السعر والتحويل ودفتر الأوامر والحداثة. إخفاقه في أي نقطة منها يلغي الدخول.
  • أربيتراج CEX والتمويل والفائدة المفتوحة متاحة في كل خطط Genesis API، وأقسام أونتشين تبدأ من Start، ودفاتر الأوامر وبيانات DEX مع Pro وMax.

بيانات أربيتراج العملات الرقمية تجيب عن خمسة أسئلة: هل يوجد فرق في السعر، وهل تستطيع نقل العملة، وهل دفتر الأوامر عميق بما يكفي لحجمك، وهل يدفع التمويل، وماذا يفعل اللاعبون الكبار. في Genesis API لكل سؤال نقطة نهاية خاصة وبضعة حقول في الاستجابة. الطلب الأول والغلاف success وdata وmeta موضحة في الدرس 2؛ وهذا الدرس عن الحقول التي تُقرأ وبأي ترتيب.

سؤال المتداول ← نقطة النهاية ← الحقول

السؤالنقطة النهايةالحقول
هل يوجد فرق في السعر/arbitrage/*spread_pct وprice_buy وprice_sell
هل تستطيع نقل العملةصف /arbitrage/spot-spot نفسهwithdraw_enabled_buy وdeposit_enabled_sell وnetwork وcontract
هل الدفتر عميق بما يكفي/orderbooks/*order_delta.spread_pct وorder_delta.status
هل يدفع التمويل/funding/*spread_pct وinterval_1 وinterval_2 وnext_payout_1
ماذا يفعل اللاعبون الكبار/onchain/* و/market/open-interestdirection وtotal_usd وoi_change_1h

النجمة تدل على مجموعة: /arbitrage/* فيها سبع نقاط نهاية، من Spot – Spot إلى الأسهم، أما /orderbooks/* و/funding/* ففي كل منهما ست. الأقسام التالية تتبع الترتيب الذي تفحص به الزوج.

هل يوجد فرق في السعر: spread_pct

صف من توثيق Spot — Spot: عملة FUEL، شراء على ByBit بسعر 0.0007029 وبيع على Gate بسعر 0.0007037، وspread_pct يساوي 0.11. التحقق: (0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%. يُحسب السبريد في الصف من price_buy وprice_sell، وهما سعرا آخر صفقة؛ وفي الموقع هذا هو عمود السعر.

في مجموعتي DEX – Spot وDEX – Futures تهمّ الإشارة: الزائد يعني أن التوكن أرخص على DEX، والناقص يعني أنه أغلى. معاملات وحقول المجموعات السبع كلها في دليل نقاط نهاية المراجحة.

spread_pct يجيب عن السؤال الأول فقط: لا يتضمن رسومًا ولا تحويلًا ولا دفتر أوامر.

هل تستطيع نقل العملة: الإيداع والسحب والشبكة والعقد

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

network وcontract يبيّنان هل هو التوكن نفسه. قد تُتداول عملات مختلفة تحت رمز واحد على منصات مختلفة، فقارن عنوان العقد مع صفحتي السحب والإيداع في المنصتين. عقود العملة في كل شبكة والمنصات التي تستخدم كلًا منها تأتي من /coins/search في أي خطة (Coin Search).

في مجموعات DEX تتبع العلمان جهة CEX: deposit_enabled وwithdraw_enabled. في Cross-chain ينتقل التوكن عبر جسر بين شبكتي buy.chain وsell.chain، فلا توجد أعلام منصات.

هل دفتر الأوامر عميق بما يكفي: سبريد الصف مقابل السبريد بعد التنفيذ

أمر السوق يمر على دفتر الأوامر: الشراء يأخذ أوامر البيع صعودًا من الأفضل، والبيع يأخذ أوامر الشراء نزولًا. كلما كبر الحجم ساء متوسط السعر وقلّ ما يبقى من سبريد الصف. Order-book Δ، أي /orderbooks/spreads/{dataset} في خطتي Pro وMax، يعيد ما يبقى لحجمك (التوثيق).

مثال توضيحي: عملة LMN، شراء على OKX بسعر 0.4000 وبيع على Bitget بسعر 0.4060. سبريد الصف: (0.4060 − 0.4000) / 0.4000 × 100 = 1.5%. طلب /orderbooks/spreads/spot-spot مع coin=LMN بقيم مختلفة لـ volume:

الحجمشراء ← بيعOrder-book Δبالدولار
00.4002 → 0.40581.3993%—
500 دولار0.4004 → 0.40551.2737%6.37 دولار
2,500 دولار0.4012 → 0.40410.7228%18.07 دولار
10,000 دولار—exhausted—

volume=0 يستخدم أفضل سعر بيع على OKX وأفضل سعر شراء على Bitget: أفضل الأوامر أسوأ من آخر الصفقات، فتضيع 0.1 نقطة مئوية حتى عند أصغر حجم. عند 2,500 دولار متوسط سعر الشراء 0.4012 ومتوسط سعر البيع 0.4041: (0.4041 − 0.4012) / 0.4012 × 100 ≈ 0.7228%. عند 10,000 دولار نفدت أوامر الشراء على Bitget وصارت order_delta.status تساوي exhausted.

كل منصة تأخذ رسم taker؛ والمثال يفترض 0.1% (maker وtaker). عند 2,500 دولار يبقى لك 0.7228 − 2 × 0.1 = 0.5228%، أي 2,500 × 0.5228 / 100 ≈ 13.07 دولار. رسوم السحب ليست في الاستجابات: ابحث عنها في صفحة السحب بالمنصة واخصمها على حدة.

في Trial وStart تعيد نقاط نهاية دفاتر الأوامر 403 plan_restricted، فتفحص الدفتر في محطة التداول بالمنصة. سعر التنفيذ والانزلاق السعري موضحان في API دفتر أوامر العملات الرقمية، ونقاط النهاية الست كلها في دليل نقاط نهاية دفتر الأوامر.

هل يدفع التمويل: الفرق والفترات ومواعيد الدفع

أربيتراج التمويل هو بيع على المكشوف حيث معدل التمويل أعلى وشراء حيث هو أدنى: حركة السعر بالكاد تغيّر النتيجة، ويتراكم فرق المعدلين. المرشحون يأتون من /funding/spread في أي خطة: أفضل زوج منصات في best وقيمة spread_pct له (Funding spread).

فرق الزوج لا يقول متى تحدث الدفعات وكم مرة. interval_1 وinterval_2 فترتا التمويل في المنصتين، وnext_payout_1 وnext_payout_2 موعدا الدفع التاليان بتوقيت UTC: لا يحصل على التمويل إلا مركز مفتوح لحظة التسوية. المعدلات ذات الفترات المختلفة تُقارن بعد توحيدها إلى 8 ساعات، وهذا هو الحقل funding_8h_pct في /funding/rates.

مثال توضيحي: فرق 0.03% لكل 8 ساعات، ومركز بقيمة 5,000 دولار على كل ساق. تسوية واحدة تعطي 5,000 × 0.03 / 100 = 1.5 دولار. أربع صفقات، أي فتح الساقين وإغلاقهما، تكلّف 4 × 5,000 × 0.1 / 100 = 20 دولارًا برسم taker بنسبة 0.1%. تُغطى الرسوم بعد 20 / 1.5 ≈ 13.3 تسوية: أي 14 تسوية كل 8 ساعات، قرابة خمسة أيام، إذا بقيت المعدلات.

يبيّن السجل هل يثبت الفرق: في Pro وMax يعيد /funding/analytics/summary مع coin لكل منصة وكل فترة قيمة sum (التمويل المتراكم) وcov (التغطية) وflips (تغيّرات الإشارة). التفاصيل في API معدل التمويل ودليل نقاط نهاية التمويل.

ماذا يفعل اللاعبون الكبار: أونتشين والفائدة المفتوحة

بيانات أونتشين والفائدة المفتوحة تفسّر لماذا قد يُغلق الزوج قبل أن تنفّذه. دخول العملة إلى منصة البيع يعني بائعين يصلون قبل تحويلك. وارتفاع الفائدة المفتوحة يعني مراكز جديدة بالرافعة، وحركة حادة ضدها تؤدي إلى تصفيات.

ما تراهالطلبالحقولالخطط
تدفقات العملة من المنصات وإليها/onchain/coin-trafficdirection وtarget وtotal_usdStart وPro وMax
فتح قفل التوكنات/onchain/unlocksunlock_value_usd وhours_leftStart وPro وMax
الفائدة المفتوحة حسب المنصة/market/open-interestoi_usd وoi_change_1h وprice_change_1hالكل

الاستجابة النموذجية في توثيق Genesis Onchain تعرض 18 تحويلًا من LAB إلى Gate بقيمة 573,796.98 دولار خلال 5.69 ساعة، وdirection تساوي deposit. إذا كان لـ LAB زوج يُباع على Gate في تلك اللحظة، فهذا التدفق سبب لتقليل الحجم أو تفويت الدخول. المزيد في API بيانات أونتشين وAPI الفائدة المفتوحة.

حداثة البيانات والطوابع الزمنية

كل استجابة تحمل وقتها: meta.updated_at هو وقت unix الذي بُنيت فيه اللقطة، وmeta.freshness_sec هو خطوة التحديث في خطتك: 60 ثانية في Trial و30 في Start و10 في Pro و5 في Max. عمر اللقطة هو الوقت الحالي ناقص updated_at (حداثة البيانات).

مثال توضيحي: خطة Trial، وصلت الاستجابة عند 1783802455 وقيمة updated_at هي 1783802410. عمر اللقطة 1783802455 − 1783802410 = 45 ثانية: حُسبت أزواجها من أسعار عمرها قرابة دقيقة، وقد يكون بعضها قد اختفى على المنصات.

لدفاتر الأوامر ساعتها الخاصة: في /orderbooks/book و/orderbooks/coin/{coin} لكل دفتر book_ts وage_sec (عمره بالثواني) وstale: true إذا زاد عمره على 30 ثانية. تتأخر الدفاتر عن المنصة 5–20 ثانية، فافحص عمر دفتري الساقين: قد يكون فرق السعر بين دفتر حديث وآخر قديم فرقًا في الزمن.

لماذا لا يكفي حقل واحد: الفحص بأربع نقاط

كل حقل يغلق سؤالًا واحدًا، ولا تدخل إلا عندما تُغلق كلها. سبريد 3% مع إغلاق السحب يترك العملة عالقة على منصة الشراء. ومع exhausted لن يمتلئ حجمك. ومع لقطة عمرها 50 ثانية قد يكون الزوج قد اختفى.

النقطةالحقوليفشل الزوج إذا
1. فرق السعرspread_pctالسبريد ناقص رسمين أقل من الحد
2. التحويلwithdraw_enabled_buy وdeposit_enabled_sell وcontractالسحب أو الإيداع مغلق أو العقد لا يطابق
3. دفتر الأوامرorder_delta.status وorder_delta.spread_pctالحالة ليست ok أو ما يبقى أقل من الحد
4. الحداثةmeta.updated_at وage_sec وstaleاللقطة أو أحد الدفاتر أقدم من الحد

تأخذ الدالة صف data من /arbitrage/spot-spot، والكائن order_delta لزوج المنصات نفسه (None في Trial وStart)، وmeta الاستجابة. الحدود توضيحية: اضبطها حسب رسومك وخطتك.

import time

FEE = 0.1      # assumed taker fee per leg, %
MIN_NET = 0.3  # at least 0.3% left after fees
MAX_AGE = 60   # snapshot no older than 60 seconds


def check(row, od, meta):
    """The points a Spot – Spot pair failed."""
    fails = []
    if row["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("1: spread does not cover the fees")
    if not row["withdraw_enabled_buy"]:
        fails.append("2: withdrawals closed on the buy exchange")
    if not row["deposit_enabled_sell"]:
        fails.append("2: deposits closed on the sell exchange")
    if od is None:
        fails.append("3: book not checked (Trial or Start)")
    elif od["status"] != "ok":
        fails.append("3: book — " + od["status"])
    elif od["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("3: too little left after the book")
    if time.time() - meta["updated_at"] > MAX_AGE:
        fails.append("4: snapshot older than MAX_AGE seconds")
    return fails

القائمة الفارغة تعني أن الزوج اجتاز النقاط الأربع. زوج LMN عند 2,500 دولار يجتازها: 1.5 − 0.2 = 1.3% في الصف، و0.7228 − 0.2 = 0.5228% بعد الدفتر، ولقطة عمرها 45 ثانية. عند 10,000 دولار تعيد الدالة "3: book — exhausted". الكود لا يستطيع التحقق من العقد: تفحص العنوان بنفسك في صفحتي السحب والإيداع بالمنصتين، وعمر دفتري الساقين يأتي من /orderbooks/book.

الفحص نفسه على جدول الموقع من دون كود في درس السبريد والعمق والحجم: قراءة الجدول، واستطلاع الـ API في حلقة في الدرس 4.

أي بيانات تأتي مع أي خطة

الخطةالحداثةبيانات المراجحة
Trial، 20 دولارًا شهريًا60 ثSpot – Spot وSpot – Futures وFutures – Futures ومعدلات التمويل وفرقه والفائدة المفتوحة وFair – Last والبامبات والبحث عن العملات
Start، 50 دولارًا30 ثكل ما في Trial مع الأسهم وأقسام أونتشين /onchain/{section} وأربيتراج التنبؤات بوضعي exact وdutch
Pro، 100 دولار10 ثكل نقاط النهاية: دفاتر الأوامر وOrder-book Δ وDEX – Spot وDEX – Futures وCross-chain وتحليلات التمويل
Max، 200 دولار5 ثنقاط النهاية نفسها في Pro، مع 15 طلبًا في الثانية

نقطة نهاية خارج خطتك تعيد 403 plan_restricted، وهذه الاستجابة لا تستهلك الحصة. حصص الطلبات وحدود الطلبات في الثانية في صفحة أسعار Genesis API.

تطبيق عملي

  1. اختر زوجًا

    في توثيق Spot — Spot افتح نموذج «جرّب الطلب» والصق مفتاحك واختر صفًا سبريده 1% أو أكثر.

  2. نفّذ النقطتين 1 و2

    اطرح رسمي 0.1% المفترضين من spread_pct وافحص withdraw_enabled_buy وdeposit_enabled_sell. قارن contract باستجابة /coins/search لهذه العملة.

  3. نفّذ النقطة 3

    في Pro أو Max اطلب /orderbooks/spreads/spot-spot لهذه العملة مع volume=1000 وابحث عن الصف الذي له زوج المنصات نفسه. في Trial وStart افتح دفتر الأوامر في محطة التداول بالمنصة.

  4. نفّذ النقطة 4

    اطرح meta.updated_at من وقت unix الحالي: الأمر date +%s يطبعه في الطرفية.

  5. سجّل الحكم

    أي نقطة سترفض الزوج أولًا، وكم يبقى من السبريد على 1,000 دولار.

أسئلة وأجوبة

ما البيانات اللازمة لأربيتراج العملات الرقمية؟

أسعار العملة على منصات مختلفة والسبريد بينها، وحالة الإيداع والسحب مع الشبكة والعقد، ودفاتر الأوامر لحساب التنفيذ بحجمك، ووقت اللقطة. أربيتراج التمويل يضيف المعدلات والفترات وأوقات الدفع. في Genesis API هذه هي /arbitrage/* و/orderbooks/* و/funding/*.

هل يمكن تنفيذ صفقة عبر Genesis API؟

لا. Genesis API يقرأ البيانات فقط ولا يضع أوامر: تفتح الصفقات بنفسك على المنصات.