Genesis Arbitrage

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

نقاط نهاية المراجحة في Genesis API: CEX وDEX وعبر السلاسل والأسهم

باختصار

  • سبع نقاط نهاية تعيد الأزواج نفسها الموجودة في جداول الموقع: مجموعات CEX الثلاث متاحة في كل الخطط، والأسهم من Start فما فوق، وDEX - سبوت وDEX - عقود آجلة وعبر السلاسل في Pro وMax.
  • يحمل صف CEX أسعار المنصتين وأفضل عروضهما والشبكة والعقد وحالة الإيداع والسحب والأحجام — وهي الحقول التي تختار بها الأزواج القابلة للتنفيذ فعلاً.
  • السبريد في الاستجابة هو فارق السعر لحظة اللقطة: لا تُخصم منه الرسوم ولا التحويلات ولا الانزلاق السعري.

تعيد نقاط نهاية المراجحة في Genesis API الأزواج نفسها الموجودة في جداول Genesis Arbitrage: فروق الأسعار بين أسواق CEX سبوت والعقود الآجلة، وبين DEX وCEX، وبين الشبكات، وعلى الأسهم المرمّزة. كل عنصر في data هو زوج واحد: أين تشتري وأين تبيع، والسبريد — فارق السعر بالنسبة المئوية — والحقول التي تتحقق بها منه: حالة الإيداع والسحب والأحجام والسيولة والروابط. نقاط النهاية السبع كلها طلبات GET والمفتاح في الترويسة X-API-Key.

سبع نقاط نهاية والخطط

نقطة النهايةما تعيدهالخطط
/arbitrage/spot-spotفروق الأسعار بين أسواق CEX سبوتTrial وStart وPro وMax
/arbitrage/spot-futuresسبوت مقابل العقود الآجلة على CEXTrial وStart وPro وMax
/arbitrage/futures-futuresالعقود الآجلة بين منصات CEXTrial وStart وPro وMax
/arbitrage/dex-spotسعر DEX مقابل سبوت CEXPro وMax
/arbitrage/dex-futuresسعر DEX مقابل عقود CEX الآجلةPro وMax
/arbitrage/crosschainرمز واحد على DEX عبر الشبكاتPro وMax
/arbitrage/stocksالأسهم المرمّزة والمعادن والمؤشرات والسلع على CEXStart وPro وMax

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

CEX: سبوت - سبوت وسبوت - عقود آجلة وعقود آجلة - عقود آجلة

نقاط نهاية CEX الثلاث تقبل المعاملات نفسها وتعيد صفوفاً بالصيغة نفسها. يبيّن الحقلان market_buy وmarket_sell سوق كل جانب: spot وspot، أو spot وfutures، أو futures وfutures.

المعاملالنوعوظيفتهمثال
coinstringالتصفية برمز العملةcoin=BTC
exchangestringالتصفية بالمنصة؛ عدة منصات مفصولة بفواصلexchange=Binance,OKX
min_spreadnumberالحد الأدنى للسبريد، %min_spread=1
min_volumenumberالحد الأدنى لحجم 24 ساعة على الجانبين، بالدولارmin_volume=50000
curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \
  -d min_spread=1 -d min_volume=50000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \
  -d coin=BTC -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \
  -d exchange=Binance,OKX -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

صف من استجابة توثيق سبوت - سبوت، مختصراً:

{
  "coin": "FUEL",
  "exchange_buy": "ByBit",
  "exchange_sell": "Gate",
  "market_buy": "spot",
  "market_sell": "spot",
  "price_buy": 0.0007029,
  "price_sell": 0.0007037,
  "ask_buy": 0.0007029,
  "bid_sell": 0.0007021,
  "spread_pct": 0.11,
  "network": "ETH",
  "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
  "withdraw_enabled_buy": true,
  "deposit_enabled_sell": true,
  "volume_24h_buy": 17652.64,
  "volume_24h_sell": 12512.51,
  "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
  …
}
الحقلالنوعالمحتوى
exchange_buy, exchange_sellstringمنصة الشراء ومنصة البيع
market_buy, market_sellstringسوق الجانب: spot أو futures
price_buy, price_sellnumberالأسعار التي يُحسب منها السبريد
bid_*, ask_*number أو nullأفضل سعر شراء وبيع على كل جانب
spread_pctnumberالسبريد، %
network, contractstring؛ string أو nullشبكة الرمز وعنوان العقد
deposit_enabled_*, withdraw_enabled_*booleanهل الإيداع والسحب مفتوحان في كل منصة
volume_24h_buy, volume_24h_sellnumber أو nullحجم 24 ساعة، بالدولار
trade_url_buy, trade_url_sellstringروابط منصات التداول

يُحسب spread_pct من price_buy وprice_sell — عمود «السعر» في الموقع، أي آخر صفقة. أما التنفيذ نفسه فيمر عبر دفتر الأوامر: تشتري عند ask_buy وتبيع عند bid_sell. في المثال bid_sell أقل من ask_buy، لذا يكون الزوج سالباً عند أفضل الأسعار:

(0.0007021 − 0.0007029) / 0.0007029 × 100 ≈ −0.11%

الفارق الدقيق لحجمك يأتي من Δ دفتر الأوامر — GET /orderbooks/spreads/{dataset}، وهو مشروح في دليل نقاط نهاية دفتر الأوامر.

أزواج سبوت - سبوت القابلة للتحويل

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

import os
import requests

r = requests.get(
    "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
    headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
    params={"min_spread": 1, "min_volume": 50000},
    timeout=15,
)
r.raise_for_status()
rows = r.json()["data"]

# لا ينجح التحويل إلا إذا كان السحب مفتوحاً في منصة الشراء
# والإيداع مفتوحاً في منصة البيع
ok = [x for x in rows
      if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
ok.sort(key=lambda x: x["spread_pct"], reverse=True)

for x in ok[:10]:
    print(f'{x["coin"]:<8} {x["exchange_buy"]} → '
          f'{x["exchange_sell"]} {x["spread_pct"]}% '
          f'network {x["network"]}')

تأتي إعادة المحاولة عند 429 و503 مع الدالة get_json من استجابات Genesis API وأخطائه. وبوت يرسل هذه الأزواج إلى Telegram مبني في مقال بوت أربيتراج العملات الرقمية بلغة Python.

DEX - سبوت وDEX - عقود آجلة

تقارن مجموعات DEX سعر العملة على DEX، أي المنصة اللامركزية، بسعرها على CEX: DEX - سبوت مقابل السبوت، وDEX - عقود آجلة مقابل العقود الآجلة. نقطتا النهاية متاحتان في خطتي Pro وMax.

المعاملالنوعوظيفتهمثال
coinstringالتصفية برمز العملةcoin=SCR
exchangestringمنصة CEX؛ عدة منصات مفصولة بفواصلexchange=MEXC
min_spreadnumberالحد الأدنى للسبريد، %min_spread=2
min_liquiditynumberالحد الأدنى للسيولة، بالدولارmin_liquidity=50000
curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
  -d min_spread=2 -d min_liquidity=50000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \
  -d min_spread=1 -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

صف DEX - سبوت من التوثيق، مختصراً:

{
  "coin": "SCR",
  "exchange": "MEXC",
  "cex_price": 0.02691,
  "dex_price": 0.02679,
  "spread_pct": 0.45,
  "network": "SCROLL",
  "liquidity_usd": 10544.15,
  "market_cap": 5091835.0,
  "deposit_enabled": true,
  "withdraw_enabled": true,
  "dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
  "dextools_url": null,
  "gmgn_url": null,
  …
}

سعر MEXC أعلى من سعر المجمّع، فالسبريد موجب. تحدد إشارة spread_pct الاتجاه: الموجب يعني أن العملة أرخص على DEX، فتشتري هناك وتبيع على CEX؛ والسالب يعني العكس.

الحقلالنوعالمحتوى
exchangestringمنصة CEX
cex_price, dex_pricenumberالسعر على CEX وعلى DEX
liquidity_usdnumberسيولة المجمّع، بالدولار
market_cap, dex_volume_24hnumber أو nullالقيمة السوقية وحجم DEX خلال 24 ساعة (DEX - سبوت)
ticker, max_position_usdstring؛ number أو nullزوج المنصة وأقصى مركز، بالدولار (DEX - عقود آجلة)
deposit_enabled, withdraw_enabledbooleanهل الإيداع والسحب مفتوحان على CEX
dexscreener_url, dextools_url, gmgn_urlstring أو nullروابط DexScreener وDEXTools وGMGN

يحوي المجمّع في المثال سيولة قدرها 10,544 $، فعملية شراء كبيرة ستحرّك سعره. يأتي الانزلاق السعري لأحجام من 100 $ إلى 100,000 $ والضرائب على الرمز وعلامة الهانيبوت لكل عقد من GET /orderbooks/dex-slippage في خطتي Pro وMax.

عبر السلاسل: رمز واحد عبر الشبكات

يقارن GET /arbitrage/crosschain سعر الرمز الواحد على DEX بين سلاسل الكتل، في خطتي Pro وMax. يحوي الصف coin وspread_pct وكائنين بالحقول نفسها: buy، وهو الجانب الأرخص، وsell، حيث يكلّف الرمز أكثر. ينتقل الرمز بين الشبكات عبر جسر عبر السلاسل.

المعاملالنوعوظيفتهمثال
coinstringالتصفية برمز الرمزcoin=WLD
chainstringالتصفية بالشبكةchain=ethereum
min_spreadnumberالحد الأدنى للسبريد، %min_spread=1
min_liquiditynumberالحد الأدنى للسيولة، بالدولارmin_liquidity=20000
curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \
  -d coin=WLD -d min_liquidity=20000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

صف من توثيق عبر السلاسل، مختصراً:

{
  "coin": "WLD",
  "spread_pct": 0.59,
  "buy": {
    "chain": "optimism",
    "pair": "WLD/USDC",
    "price_usd": 0.4048,
    "liquidity_usd": 48747,
    "volume_24h_usd": 2484,
    "pool_created_at": "2023-07-24 08:44:19 UTC",
    …
  },
  "sell": {
    "chain": "ethereum",
    "pair": "WLD/WETH",
    "price_usd": 0.4072,
    "liquidity_usd": 421426,
    …
  }
}
الحقلالنوعالمحتوى
buy.chainstringشبكة الجانب
buy.pairstringزوج DEX، مثل WLD/USDC
buy.contractstringعنوان العقد على تلك الشبكة
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usdnumberالسعر وسيولة المجمّع وحجم 24 ساعة، بالدولار
buy.pool_created_atstring أو nullتاريخ إنشاء المجمّع
buy.dexscreener_url, dextools_url, gmgn_urlstring أو nullروابط DexScreener وDEXTools وGMGN

للجانب sell الحقول نفسها. pool_created_at سلسلة تاريخ بتوقيت UTC، وليست ثواني unix كمعظم الطوابع الزمنية في API، ويمكن أن تكون null. المجمّع الذي أُنشئ قبل أيام قليلة سبب للتحقق من العقدين على الجانبين: فقد يختبئ رمز مختلف خلف الرمز نفسه على شبكة جديدة.

مراجحة الأسهم: أسهم ومعادن ومؤشرات وسلع

يعيد GET /arbitrage/stocks فروق الأسعار على الأسهم المرمّزة والمعادن والمؤشرات والسلع بين منصات CEX، وهو متاح من خطة Start فما فوق.

المعاملالنوعوظيفتهمثال
symbolstringالتصفية برمز الأداةsymbol=BRENT
categorystringالفئة: Stock أو Metal أو Index أو Commoditycategory=Commodity
exchangestringالتصفية بالمنصة؛ عدة منصات مفصولة بفواصلexchange=MEXC
min_spreadnumberالحد الأدنى للسبريد، %min_spread=0.3
curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
  -d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

صف من توثيق مراجحة الأسهم، مختصراً:

{
  "symbol": "BRENT",
  "category": "Commodity",
  "exchange_buy": "MEXC",
  "exchange_sell": "Ourbit",
  "symbol_on_buy": "UKOIL",
  "symbol_on_sell": "BRENTOIL",
  "price_buy": 76.68,
  "price_sell": 76.82,
  "spread_pct": 0.18,
  …
}

symbol هو الرمز الشائع للأداة، أما symbol_on_buy وsymbol_on_sell فهما اسماها في كل منصة: في المثال يُتداول خام برنت باسم UKOIL على MEXC وباسم BRENTOIL على Ourbit. ابحث عن الأداة في المنصة بـ symbol_on_*. لا يحوي الصف شبكة ولا عقداً ولا حقول إيداع: فهذه الأدوات تُتداول على CEX كـعقود آجلة دائمة، ويُفتح الزوج بمركزي Long وShort (دليل الجدول).

استجابات API وجداول الموقع

أعمدة جداول الموقع مشروحة في الأدلة:

نقطة النهايةجدول الموقع ودليله
/arbitrage/spot-spotسبوت - سبوت
/arbitrage/spot-futuresسبوت - عقود آجلة
/arbitrage/futures-futuresمراجحة العقود الآجلة
/arbitrage/dex-spotDEX - سبوت
/arbitrage/dex-futuresDEX - عقود آجلة
/arbitrage/crosschainكروس تشين
/arbitrage/stocksمراجحة الأسهم

كيف تبني مراقب أزواج

  1. اختر نقطة النهاية المناسبة لخطتك

    راجع جدول الخطط أعلاه: مجموعات DEX وعبر السلاسل في Pro وMax فقط.

  2. ضيّق المجموعة على الخادم

    اضبط min_spread فوق مجموع رسومك، وmin_volume أو min_liquidity لاستبعاد العملات ضعيفة السيولة.

  3. أبقِ الصفوف القابلة للتنفيذ في الشيفرة

    سبوت - سبوت — withdraw_enabled_buy وdeposit_enabled_sell. DEX - سبوت بسبريد موجب — deposit_enabled، وبسبريد سالب — withdraw_enabled. الأسهم — ابحث بـ symbol_on_buy وsymbol_on_sell.

  4. تحقق من الرمز ودفتر الأوامر

    قارن contract وnetwork، واحسب التنفيذ لحجمك بنقاط نهاية دفتر الأوامر.

  5. استطلع بوتيرة خطتك

    ليس أسرع من meta.freshness_sec. يرسل البوت تنبيهاً، وتفتح الصفقة بنفسك في المنصة.

أسئلة وأجوبة

هل تستطيع نقاط النهاية هذه تنفيذ صفقة؟

لا. Genesis API يقدّم البيانات فقط ولا يضع أوامر. البوت المبني على Genesis API يجد الزوج ويرسل لك تنبيهاً، وتفتح الصفقة بنفسك في المنصة.

لماذا لا تحوي الصفوف أعمدة Book أو Ord.؟

كلاهما يُحسب من دفاتر الأوامر ويأتي منفصلاً: Δ دفتر الأوامر من GET /orderbooks/spreads/{dataset} ودفتر أوامر السوق من GET /orderbooks/book، وكلاهما في خطتي Pro وMax.

أي خطة أحتاج لـ DEX وعبر السلاسل؟

Pro أو Max. تغطي Trial مجموعات CEX الثلاث، وتضيف Start مراجحة الأسهم.