نقاط نهاية المراجحة في 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 | سبوت مقابل العقود الآجلة على CEX | Trial وStart وPro وMax |
/arbitrage/futures-futures | العقود الآجلة بين منصات CEX | Trial وStart وPro وMax |
/arbitrage/dex-spot | سعر DEX مقابل سبوت CEX | Pro وMax |
/arbitrage/dex-futures | سعر DEX مقابل عقود CEX الآجلة | Pro وMax |
/arbitrage/crosschain | رمز واحد على DEX عبر الشبكات | Pro وMax |
/arbitrage/stocks | الأسهم المرمّزة والمعادن والمؤشرات والسلع على CEX | Start وPro وMax |
نقطة النهاية الخارجة عن خطتك تعيد 403 plan_restricted؛ رموز الأخطاء في استجابات Genesis API وأخطاؤه، والأسعار في صفحة أسعار Genesis API.
CEX: سبوت - سبوت وسبوت - عقود آجلة وعقود آجلة - عقود آجلة
نقاط نهاية CEX الثلاث تقبل المعاملات نفسها وتعيد صفوفاً بالصيغة نفسها. يبيّن الحقلان market_buy وmarket_sell سوق كل جانب: spot وspot، أو spot وfutures، أو futures وfutures.
| المعامل | النوع | وظيفته | مثال |
|---|---|---|---|
coin | string | التصفية برمز العملة | coin=BTC |
exchange | string | التصفية بالمنصة؛ عدة منصات مفصولة بفواصل | exchange=Binance,OKX |
min_spread | number | الحد الأدنى للسبريد، % | min_spread=1 |
min_volume | number | الحد الأدنى لحجم 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_sell | string | منصة الشراء ومنصة البيع |
market_buy, market_sell | string | سوق الجانب: spot أو futures |
price_buy, price_sell | number | الأسعار التي يُحسب منها السبريد |
bid_*, ask_* | number أو null | أفضل سعر شراء وبيع على كل جانب |
spread_pct | number | السبريد، % |
network, contract | string؛ string أو null | شبكة الرمز وعنوان العقد |
deposit_enabled_*, withdraw_enabled_* | boolean | هل الإيداع والسحب مفتوحان في كل منصة |
volume_24h_buy, volume_24h_sell | number أو null | حجم 24 ساعة، بالدولار |
trade_url_buy, trade_url_sell | string | روابط منصات التداول |
يُحسب 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.
| المعامل | النوع | وظيفته | مثال |
|---|---|---|---|
coin | string | التصفية برمز العملة | coin=SCR |
exchange | string | منصة CEX؛ عدة منصات مفصولة بفواصل | exchange=MEXC |
min_spread | number | الحد الأدنى للسبريد، % | min_spread=2 |
min_liquidity | number | الحد الأدنى للسيولة، بالدولار | 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؛ والسالب يعني العكس.
| الحقل | النوع | المحتوى |
|---|---|---|
exchange | string | منصة CEX |
cex_price, dex_price | number | السعر على CEX وعلى DEX |
liquidity_usd | number | سيولة المجمّع، بالدولار |
market_cap, dex_volume_24h | number أو null | القيمة السوقية وحجم DEX خلال 24 ساعة (DEX - سبوت) |
ticker, max_position_usd | string؛ number أو null | زوج المنصة وأقصى مركز، بالدولار (DEX - عقود آجلة) |
deposit_enabled, withdraw_enabled | boolean | هل الإيداع والسحب مفتوحان على CEX |
dexscreener_url, dextools_url, gmgn_url | string أو 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، حيث يكلّف الرمز أكثر. ينتقل الرمز بين الشبكات عبر جسر عبر السلاسل.
| المعامل | النوع | وظيفته | مثال |
|---|---|---|---|
coin | string | التصفية برمز الرمز | coin=WLD |
chain | string | التصفية بالشبكة | chain=ethereum |
min_spread | number | الحد الأدنى للسبريد، % | min_spread=1 |
min_liquidity | number | الحد الأدنى للسيولة، بالدولار | 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.chain | string | شبكة الجانب |
buy.pair | string | زوج DEX، مثل WLD/USDC |
buy.contract | string | عنوان العقد على تلك الشبكة |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | السعر وسيولة المجمّع وحجم 24 ساعة، بالدولار |
buy.pool_created_at | string أو null | تاريخ إنشاء المجمّع |
buy.dexscreener_url, dextools_url, gmgn_url | string أو null | روابط DexScreener وDEXTools وGMGN |
للجانب sell الحقول نفسها. pool_created_at سلسلة تاريخ بتوقيت UTC، وليست ثواني unix كمعظم الطوابع الزمنية في API، ويمكن أن تكون null. المجمّع الذي أُنشئ قبل أيام قليلة سبب للتحقق من العقدين على الجانبين: فقد يختبئ رمز مختلف خلف الرمز نفسه على شبكة جديدة.
مراجحة الأسهم: أسهم ومعادن ومؤشرات وسلع
يعيد GET /arbitrage/stocks فروق الأسعار على الأسهم المرمّزة والمعادن والمؤشرات والسلع بين منصات CEX، وهو متاح من خطة Start فما فوق.
| المعامل | النوع | وظيفته | مثال |
|---|---|---|---|
symbol | string | التصفية برمز الأداة | symbol=BRENT |
category | string | الفئة: Stock أو Metal أو Index أو Commodity | category=Commodity |
exchange | string | التصفية بالمنصة؛ عدة منصات مفصولة بفواصل | exchange=MEXC |
min_spread | number | الحد الأدنى للسبريد، % | 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-spot | DEX - سبوت |
/arbitrage/dex-futures | DEX - عقود آجلة |
/arbitrage/crosschain | كروس تشين |
/arbitrage/stocks | مراجحة الأسهم |
كيف تبني مراقب أزواج
اختر نقطة النهاية المناسبة لخطتك
راجع جدول الخطط أعلاه: مجموعات DEX وعبر السلاسل في Pro وMax فقط.
ضيّق المجموعة على الخادم
اضبط
min_spreadفوق مجموع رسومك، وmin_volumeأوmin_liquidityلاستبعاد العملات ضعيفة السيولة.أبقِ الصفوف القابلة للتنفيذ في الشيفرة
سبوت - سبوت —
withdraw_enabled_buyوdeposit_enabled_sell. DEX - سبوت بسبريد موجب —deposit_enabled، وبسبريد سالب —withdraw_enabled. الأسهم — ابحث بـsymbol_on_buyوsymbol_on_sell.تحقق من الرمز ودفتر الأوامر
قارن
contractوnetwork، واحسب التنفيذ لحجمك بنقاط نهاية دفتر الأوامر.استطلع بوتيرة خطتك
ليس أسرع من
meta.freshness_sec. يرسل البوت تنبيهاً، وتفتح الصفقة بنفسك في المنصة.
أسئلة وأجوبة
هل تستطيع نقاط النهاية هذه تنفيذ صفقة؟
لا. Genesis API يقدّم البيانات فقط ولا يضع أوامر. البوت المبني على Genesis API يجد الزوج ويرسل لك تنبيهاً، وتفتح الصفقة بنفسك في المنصة.
لماذا لا تحوي الصفوف أعمدة Book أو Ord.؟
كلاهما يُحسب من دفاتر الأوامر ويأتي منفصلاً: Δ دفتر الأوامر من GET /orderbooks/spreads/{dataset} ودفتر أوامر السوق من GET /orderbooks/book، وكلاهما في خطتي Pro وMax.
أي خطة أحتاج لـ DEX وعبر السلاسل؟
Pro أو Max. تغطي Trial مجموعات CEX الثلاث، وتضيف Start مراجحة الأسهم.