بيانات 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-interest | direction و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 Δ | بالدولار |
|---|---|---|---|
0 | 0.4002 → 0.4058 | 1.3993% | — |
| 500 دولار | 0.4004 → 0.4055 | 1.2737% | 6.37 دولار |
| 2,500 دولار | 0.4012 → 0.4041 | 0.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-traffic | direction وtarget وtotal_usd | Start وPro وMax |
| فتح قفل التوكنات | /onchain/unlocks | unlock_value_usd وhours_left | Start وPro وMax |
| الفائدة المفتوحة حسب المنصة | /market/open-interest | oi_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.
تطبيق عملي
اختر زوجًا
في توثيق Spot — Spot افتح نموذج «جرّب الطلب» والصق مفتاحك واختر صفًا سبريده 1% أو أكثر.
نفّذ النقطتين 1 و2
اطرح رسمي 0.1% المفترضين من
spread_pctوافحصwithdraw_enabled_buyوdeposit_enabled_sell. قارنcontractباستجابة/coins/searchلهذه العملة.نفّذ النقطة 3
في Pro أو Max اطلب
/orderbooks/spreads/spot-spotلهذه العملة معvolume=1000وابحث عن الصف الذي له زوج المنصات نفسه. في Trial وStart افتح دفتر الأوامر في محطة التداول بالمنصة.نفّذ النقطة 4
اطرح
meta.updated_atمن وقت unix الحالي: الأمرdate +%sيطبعه في الطرفية.سجّل الحكم
أي نقطة سترفض الزوج أولًا، وكم يبقى من السبريد على 1,000 دولار.
أسئلة وأجوبة
ما البيانات اللازمة لأربيتراج العملات الرقمية؟
أسعار العملة على منصات مختلفة والسبريد بينها، وحالة الإيداع والسحب مع الشبكة والعقد، ودفاتر الأوامر لحساب التنفيذ بحجمك، ووقت اللقطة. أربيتراج التمويل يضيف المعدلات والفترات وأوقات الدفع. في Genesis API هذه هي /arbitrage/* و/orderbooks/* و/funding/*.
هل يمكن تنفيذ صفقة عبر Genesis API؟
لا. Genesis API يقرأ البيانات فقط ولا يضع أوامر: تفتح الصفقات بنفسك على المنصات.