Genesis Arbitrage

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

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 فيتحرك السعر مع تدفق الأوامر في الدفتر. تستمر الفجوة حتى يغلقها مراجح، وإليك ما يعيق ذلك:

في المراجحة تحدد إشارة الفرق اتجاه الصفقة، ويحدد الاتجاه ما يجب أن يكون مفتوحاً في المنصة وأي بيانات من ساق DEX يجب قراءتها:

spread_pctالصفقةالمطلوب في CEXبيانات ساق DEX
أكبر من 0شراء في DEX، إيداع في المنصة، بيعdeposit_enabledslippage_buy_pct, tax_buy_pct
أقل من 0شراء في المنصة، سحب، بيع في DEXwithdraw_enabledslippage_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_usdDEX — Futures
/arbitrage/crosschainرمز واحد في منصات DEX في شبكتين، عمر المجمّعCross-chain
/orderbooks/dex-slippageالانزلاق من 100$ إلى 100,000$، الضرائب، honeypotانزلاق DEX
/market/dex-dumpsانهيارات الرموز في DEX وهل يتداول الرمز في CEXDEX 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 دون بلوغ الحدود.

مخاطر لا يُظهرها الفرق السعري

أسئلة وأجوبة

هل أستطيع شراء رمز عبر 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.