API DEX: أسعار DEX والسيولة والانزلاق بجانب سعر CEX
باختصار
- يعيد API DEX سعر الرمز في المجمّع والسيولة والحجم والقيمة السوقية والعقد والشبكة. وللمراجحة تحتاج أيضاً إلى سعر CEX للعقد نفسه، وتعيده نقاط DEX – Spot وDEX – Futures في Genesis API ضمن خطتي Pro وMax.
- يعتمد سعر DEX على حجم الصفقة لأن مجمّع السيولة هو الذي يحدده. في مثال افتراضي يترك فرق 3% مبلغ 11$ في صفقة بقيمة 2,500$، ويصبح سالباً عند 5,000$ بعد الانزلاق وضريبة الرمز والغاز.
- تعيد
/orderbooks/dex-slippageالانزلاق لحجم صفقتك وضريبتي الشراء والبيع وعلامة honeypot. يقرأ Genesis API البيانات فقط: توقّع عملية المبادلة بنفسك في محفظتك.
API DEX هو وصول برمجي إلى بيانات المنصات اللامركزية (DEX): سعر الرمز في المجمّع، وسيولة المجمّع، وحجم التداول، والقيمة السوقية، وعنوان العقد، والشبكة. ليس لدى معظم منصات DEX دفتر أوامر ولا عملية إدراج: مجمّع السيولة هو الذي يحدد السعر، ويستطيع أي شخص إنشاء مجمّع. لذلك يجب أن يعيد API DEX مع السعر البيانات اللازمة للتحقق من الرمز والمجمّع.
في المراجحة يُقارن سعر DEX بسعر CEX للعقد نفسه، ويُحسب ما يبقى من الفرق السعري عند حجم صفقتك بعد الانزلاق وضريبة الرمز والغاز. في Genesis API تأتي أزواج DEX ↔ CEX من /arbitrage/dex-spot و/arbitrage/dex-futures، أما الانزلاق والضرائب وعلامة honeypot لكل عقد فتأتي من /orderbooks/dex-slippage.
كيف يحدد DEX سعره
في معظم منصات DEX تمرّ المبادلة عبر مجمّع سيولة — عقد ذكي يحتفظ باحتياطيات رمزين، مثلاً رمز وUSDC. السعر هو نسبة الاحتياطيات. الشراء يسحب الرمز من المجمّع ويضيف USDC، فتكلّف كل وحدة تالية من الرمز أكثر من سابقتها.
يصف Uniswap هذا المجمّع بـصيغة الجداء الثابت x × y = k، حيث x وy هما احتياطيا الرمزين: بعد المبادلة يجب ألا ينقص الجداء.
مثال افتراضي: يحتوي مجمّع على سيولة 200,000$، بواقع 100,000$ في كل جانب. شراء بقيمة 1,000$ يحرّك متوسط السعر بمقدار 2 × 1,000 / 200,000 = 1%، وشراء بقيمة 10,000$ بمقدار 10%. الحساب خطوة بخطوة مع جدول موجود في الدرس ما هي مراجحة DEX.
تصف الصيغة مجمّعاً كلاسيكياً واحداً. في Uniswap v3 وv4 تُطبَّق ضمن نطاقات الأسعار التي يختارها مزوّدو السيولة، ويُجمَّع سعر DEX في صفوف Genesis Arbitrage حسب العقد والشبكة. لذا يأتي الانزلاق الدقيق لحجم صفقة معيّن من البيانات، وتخدم الصيغة كتقدير سريع.
ما الذي تحتاجه من API DEX
الحكم على زوج DEX ↔ CEX يتطلب أكثر من سعر واحد. إليك ما تحتاجه ومكانه في استجابات Genesis API:
| البيانات | أهميتها في المراجحة | حقل Genesis API |
|---|---|---|
| سعر DEX وCEX | الفرق السعري واتجاهه | dex_price, cex_price, spread_pct |
| سيولة المجمّع | إلى أي مدى تحرّك الصفقة السعر | liquidity_usd |
| حجم 24 ساعة | هل يجري التداول في المجمّع أصلاً | dex_volume_24h, volume_24h_usd |
| القيمة السوقية | حجم الرمز | market_cap |
| العقد والشبكة | هل هو الرمز نفسه الموجود في المنصة | contract, network أو chain |
| عمر المجمّع | المجمّع الحديث سبب لإعادة فحص العقد | pool_created_at |
| الإيداع والسحب في CEX | هل يمكن نقل الرمز إلى المنصة أو منها | deposit_enabled, withdraw_enabled |
| الانزلاق والضريبة وhoneypot | كم يبقى من الفرق | /orderbooks/dex-slippage |
| روابط المجمّع | اطّلع بنفسك على المجمّع وصفقاته | dexscreener_url, dextools_url, gmgn_url |
القيمة السوقية وحجم DEX موجودان في DEX – Spot، وعمر المجمّع في جانبي buy وَsell في Cross-chain. طلب لصف DEX – Spot لعملة واحدة:
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d coin=SCR \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
صف من توثيق DEX — Spot، مختصر:
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"contract": "0xd29687c813D741E2F938F4aC377128810E217b1b",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"dex_volume_24h": 319.73,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
…
}
الرمز أغلى في MEXC منه في المجمّع، فالفرق موجب: 0.45%. سيولة المجمّع 10,544$ وحجم DEX خلال 24 ساعة نحو 320$. إذا كان هذا مجمّعاً كلاسيكياً واحداً، فسيكون متوسط سعر شراء بقيمة 1,000$ أعلى من السعر الابتدائي بنحو 2 × 1,000 / 10,544 ≈ 19% — أي أكثر من 40 ضعف الفرق. قد تكون الروابط null: في هذا الصف يوجد dexscreener_url فقط.
لماذا تنحرف أسعار DEX عن أسعار CEX
يتغير سعر المجمّع بالصفقات فيه فقط، ويظهر السعر الجديد من الخارج مع كل كتلة: تقسّم Ethereum الوقت إلى فتحات مدتها 12 ثانية. أما في CEX فيتحرك السعر مع تدفق الأوامر في الدفتر. تستمر الفجوة حتى يغلقها مراجح، وإليك ما يعيق ذلك:
- الإيداع أو السحب مغلق. إذا تعذّر نقل الرمز إلى المنصة أو منها، يعيش السوقان منفصلين. في الصف يُمثَّل ذلك بـ
deposit_enabledوَwithdraw_enabled. - التكاليف تتجاوز الفجوة. الغاز ورسوم المجمّع والمنصة: فجوة أصغر من هذه التكاليف لا تستحق الإغلاق.
- ضريبة الرمز. مع ضريبة شراء 5% تلتهم الضريبة نفسها فجوة تصل إلى 5%.
- مجمّع ضعيف السيولة. في مجمّع بقيمة عشرات آلاف الدولارات تحرّك صفقة متوسطة واحدة السعر.
- رمز مختلف. قد يتداول في DEX نسخة بعقد مختلف تحت الرمز نفسه. يقارن Genesis Arbitrage الأسعار فقط عند تطابق عنوان العقد.
في المراجحة تحدد إشارة الفرق اتجاه الصفقة، ويحدد الاتجاه ما يجب أن يكون مفتوحاً في المنصة وأي بيانات من ساق DEX يجب قراءتها:
spread_pct | الصفقة | المطلوب في CEX | بيانات ساق DEX |
|---|---|---|---|
| أكبر من 0 | شراء في DEX، إيداع في المنصة، بيع | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| أقل من 0 | شراء في المنصة، سحب، بيع في DEX | withdraw_enabled | slippage_sell_pct, tax_sell_pct |
وبينما ينتقل الرمز بين المحفظة والمنصة قد يُغلق الفرق. في زوج DEX – Futures يعوّض مركز بيع في العقود الآجلة يُفتح مع الشراء في DEX حركة السعر، لكن معه مخاطر الهامش والتمويل والتصفية — راجع الدرس المراجحة: DEX — Futures. يحتوي صف DEX – Futures أيضاً على max_position_usd، أي الحد الأقصى لحجم المركز، حيث توفره المنصة.
الانزلاق وضريبة الرمز وhoneypot
تصف /orderbooks/dex-slippage ساق DEX في الزوج حسب العقد: انزلاق الشراء والبيع للأحجام من 100$ إلى 100,000$، وضريبتي الشراء والبيع للرمز، وعلامة honeypot (الـhoneypot رمز يمكنك شراؤه ولا يمكنك بيعه). وهي البيانات نفسها الموجودة في أعمدة جدول DEX على الموقع. المرشّحات هي contract (مفصولة بفواصل لعدة عناوين) وَnetwork؛ وتوصف الحقول في قسم انزلاق DEX.
مثال استجابة من التوثيق لعقد واحد:
{
"sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
100000],
"contracts": [
{
"contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"network": "ETH",
"tax_buy_pct": 0,
"tax_sell_pct": 0,
"honeypot": "no",
"slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
1.41, 3.12, 6.05],
"slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
1.5, 3.3, 6.4],
"updated_at": 1794671040
}
]
}
تتبع المصفوفات شبكة sizes_usd: شراء بقيمة 1,000$ يفقد 0.36%، وبقيمة 10,000$ يفقد 0.86%، وبقيمة 100,000$ يفقد 6.05%. القيمة null في المصفوفة تعني أن المجمّع تنقصه السيولة لهذا الحجم. يأخذ honeypot ثلاث قيم: no، وsuspect — المصادر غير متفقة، وyes — قد يكون البيع مستحيلاً. لكل عقد وقت تحديث خاص به في updated_at.
مثال افتراضي: فرق 3% وما يتبقى منه
يكلّف الرمز 1.00$ في DEX و1.03$ في CEX: فرق 3% على سعر الشراء، فتشتري في DEX وتبيع في المنصة. ضريبة الشراء 1%، ورسوم المنصة على البيع 0.1%، والغاز للمبادلة والتحويل إلى المنصة 4$. سلّم slippage_buy_pct: 0.5% عند 500$، و0.7% عند 1,000$، و1.3% عند 2,500$، و2.3% عند 5,000$.
| حجم الصفقة | الانزلاق | الغاز، % من الحجم | المتبقي من الفرق |
|---|---|---|---|
| 500$ | 0.5% | 0.8% | 0.6%، أي 3$ |
| 1,000$ | 0.7% | 0.4% | 0.8%، أي 8$ |
| 2,500$ | 1.3% | 0.16% | 0.44%، أي 11$ |
| 5,000$ | 2.3% | 0.08% | −0.48%، أي −24$ |
لصفقة 5,000$: 3 − 2.3 − 1 − 0.1 − 0.08 = −0.48%، أي خسارة 24$ في الصفقة. جمع النسب المئوية مقبول للتقدير؛ والحساب الدقيق بالجداءات يخرج أقل ببضعة أجزاء من مئة من النسبة المئوية.
بالدولار يبقى أكبر مبلغ عند 2,500$، بينما عند 5,000$ يجعل الفرق نفسه الصفقة سالبة. مع نمو الحجم تتقلص حصة الغاز ويزداد الانزلاق، فلكل زوج حجم عمل خاص به. مع honeypot: "yes" وفرق سالب لا شيء يُحسب: قد لا يُباع في المجمّع رمز اشتُري في المنصة.
يستخدم بيع CEX في المثال سعر الصف. عملياً تتحقق منه من دفتر أوامر المنصة: Δ دفتر الأوامر لصفوف DEX تأتي من /orderbooks/spreads/dex-spot للمبالغ 500$ و1,000$ و2,500$ و5,000$ و10,000$ — الحقول في التوثيق، وشرح خطوة بخطوة في الدليل نقاط نهاية دفتر الأوامر.
نقاط DEX في Genesis API
| نقطة النهاية | ما تعيده | التوثيق |
|---|---|---|
/arbitrage/dex-spot | سعر DEX مقابل Spot في CEX، السيولة، القيمة السوقية، الحجم | DEX — Spot |
/arbitrage/dex-futures | سعر DEX مقابل العقود الآجلة في CEX، max_position_usd | DEX — Futures |
/arbitrage/crosschain | رمز واحد في منصات DEX في شبكتين، عمر المجمّع | Cross-chain |
/orderbooks/dex-slippage | الانزلاق من 100$ إلى 100,000$، الضرائب، honeypot | انزلاق DEX |
/market/dex-dumps | انهيارات الرموز في DEX وهل يتداول الرمز في CEX | DEX Dumps |
تعمل الخمس جميعها في خطتي API: Pro (100$ شهرياً، حداثة 10 ث) وMax (200$، حداثة 5 ث)؛ وفي Trial وStart تعيد 403 plan_restricted. تقبل DEX – Spot وDEX – Futures المعاملات coin وَexchange وَmin_spread وَmin_liquidity، وتقبل Cross-chain المعامل chain بدل exchange، وتقبل DEX Dumps المعاملين chain وَmin_liquidity. المعاملات والحقول موضحة في الدليل نقاط نهاية الأربيتراج في Genesis API، والأسعار في صفحة أسعار Genesis API.
يقارن min_spread الفرق بإشارته: min_spread=2 يستبعد أيضاً صفاً فرقه −5%. لرؤية الاتجاهين طبّق العتبة على القيمة المطلقة في الكود، كما يفعل المثال أدناه. المبادلات الكبيرة في المجمّعات مع تقدير أثر السعر تأتي من نقطة أونتشين /onchain/dex-swaps، وهي موضحة في المقال API بيانات أونتشين.
وبلا كود يعرض جدول الموقع الأزواج نفسها: أعمدته ومرشّحاته وترتيب الفحص موصوفة في كيف تستخدم جدول DEX – Spot.
مثال Python: أزواج DEX – Spot بلا فخاخ
يأخذ السكربت أزواج DEX – Spot ذات السيولة من 50,000$ وفرق مطلق من 2%، ويطلب الانزلاق والضرائب لعقودها، ويستبعد honeypot: "yes" والضرائب فوق 5%. وللباقي يحسب ما يتبقى من الفرق عند 1,000$ بعد الانزلاق والضريبة. يأتي المفتاح من متغير البيئة GENESIS_API_KEY.
تنتظر دالة الطلب Retry-After ثانية عند 429 وَ503. وعند استنفاد الحصة الشهرية يعدّ Retry-After تنازلياً حتى إعادة ضبط الحصة وقد يصل إلى أيام، لذا لا يبدأ السكربت انتظاراً طويلاً:
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get(path, params=None):
for _ in range(3):
r = requests.get(API + path, headers=HEADERS,
params=params, timeout=15)
if r.status_code == 403:
raise SystemExit("DEX endpoints need the Pro or Max plan")
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # monthly quota used up
raise SystemExit(f"quota used up, retry in {wait} s")
time.sleep(wait)
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("API busy, try again later")
اختيار الأزواج وفحص العقود:
SIZE = 1000 # trade size, USD: one of the sizes_usd values
MAX_TAX = 5 # skip tokens taxed above 5%
rows = get("/arbitrage/dex-spot", {"min_liquidity": 50000})
rows = [x for x in rows
if x["contract"] and abs(x["spread_pct"]) >= 2]
addrs = sorted({x["contract"].lower() for x in rows})
checks, sizes = {}, []
for i in range(0, len(addrs), 50): # up to 50 addresses per call
d = get("/orderbooks/dex-slippage",
{"contract": ",".join(addrs[i:i + 50])})
sizes = d["sizes_usd"]
for c in d["contracts"]: # addresses come in lowercase
checks[c["contract"]] = c
found = []
for x in rows:
c = checks.get(x["contract"].lower())
if c is None or c["honeypot"] == "yes":
continue # no data, or selling may be impossible
taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
if t is not None] # null means no source, not 0%
if any(t > MAX_TAX for t in taxes):
continue
buy = x["spread_pct"] >= 0 # positive: buy on the DEX
ladder = c["slippage_buy_pct" if buy else "slippage_sell_pct"]
k = sizes.index(SIZE)
slip = ladder[k] if k < len(ladder) else None
if slip is None:
continue # the pool lacks liquidity for SIZE
tax = c["tax_buy_pct" if buy else "tax_sell_pct"]
left = abs(x["spread_pct"]) - slip - (tax or 0)
found.append((left, x, c["honeypot"], tax))
for left, x, hp, tax in sorted(found, key=lambda f: -f[0]):
print(f'{x["coin"]:<8} {x["exchange"]:<8} '
f'spread {x["spread_pct"]:+.2f}%, left {left:.2f}%, '
f'tax {"no data" if tax is None else tax}, '
f'honeypot {hp}')
لا يخصم السكربت الغاز ورسوم المنصة، فأضف أرقام شبكتك ومنصتك. ويتخطى الصفوف التي لا بيانات لها في /orderbooks/dex-slippage: افحص تلك الرموز يدوياً عبر روابط الصف. تُقارن العناوين بأحرف صغيرة لأن DEX – Spot قد يعيد العقد بأحرف مختلطة، كما في المثال أعلاه.
استعلم في حلقة بما لا يزيد عن meta.freshness_sec. في Pro يعني ذلك كل 10 ثوانٍ: 30 × 86,400 / 10 = 259,200 طلباً إلى نقطة نهاية واحدة خلال 30 يوماً مقابل حصة 5M. توفير الحصة والحركة موضح في كيف تستعلم من API دون بلوغ الحدود.
مخاطر لا يُظهرها الفرق السعري
- MEV وهجمات الساندويتش. يستطيع بوت رؤية مبادلتك في DEX قبل أن تدخل كتلة: يشتري قبلك ويبيع بعدك مباشرة ويأخذ جزءاً من الفرق. كلما اتسع تفاوت الانزلاق في محفظتك زاد ما يستطيع أخذه؛ والحماية موضحة في MEV وهجمات الساندويتش في DEX.
- صلاحيات مالك الرمز. إن سمح العقد بذلك، يستطيع المالك رفع الضريبة أو منع البيع بعد شرائك، ولا يحميك
honeypot: "no"والضريبة الصفرية اليوم من ذلك. صلاحيات العقد وأقفال السيولة تُفحص خطوة بخطوة في كيف تفحص الرمز قبل الشراء. - تأخر البيانات. تصل الأسعار بتأخر خطتك وسلّم الانزلاق مع
updated_atالخاص به. قبل الصفقة تحقق من سعر المجمّع عبر رابط الصف ومن دفتر الأوامر في المنصة. - التحويل إلى المنصة. قد يُغلق الإيداع أثناء مرور الرمز، ويحتاج الإيداع إلى تأكيدات الشبكة، وهو رقم تحدده كل منصة بنفسها.
- الغاز. في الشبكة المزدحمة يرتفع الغاز ويأكل الفرق في الصفقات الصغيرة.
أسئلة وأجوبة
هل أستطيع شراء رمز عبر Genesis API؟
لا. يعيد Genesis API البيانات فقط ولا يضع أي أوامر، لا في منصات DEX ولا في المنصات المركزية. توقّع مبادلات DEX في محفظتك بنفسك، وتفتح صفقات CEX في المنصة بنفسك.
كم مرة تُحدَّث أسعار DEX في API؟
يتغير سعر المجمّع مع كل صفقة فيه ويظهر من الخارج مع كل كتلة جديدة. تحدّث نواة Genesis Arbitrage البيانات كل ثانية، ويقدّمها API بحداثة خطتك: 10 ث في Pro و5 ث في Max، وهما الخطتان الوحيدتان اللتان فيهما نقاط DEX. وقت بناء اللقطة في meta.updated_at؛ وللانزلاق والضرائب updated_at خاص بكل عقد.
ماذا تعني null في ضريبة الرمز؟
أنه لا يوجد مصدر لبيانات ضريبة هذا الرمز. لا تعامله كصفر: قد تكون الضريبة أي قيمة. يُبقي مثال Python أعلاه هذه الصفوف ويطبع «tax no data» لتفحصها يدوياً.
أي خطة Genesis API أحتاج لبيانات DEX؟
Pro (100$ شهرياً) أو Max (200$). في Trial وStart تعيد DEX – Spot وDEX – Futures وCross-chain وDEX Dumps وانزلاق DEX الخطأ 403 plan_restricted.
هل تتضمن الاستجابات روابط DexScreener؟
نعم. تحمل صفوف DEX – Spot وDEX – Futures وجانبا Cross-chain الحقول dexscreener_url وَdextools_url وَgmgn_url، وهي روابط إلى صفحة المجمّع أو الرمز. وعند غياب الرابط يكون الحقل null. في DEX Dumps رابط المجمّع هو pool_url، والباقي في المصفوفة links.