Genesis Arbitrage

Genesis Arbitrage · · 14 دقیقه مطالعه

API DEX: قیمت DEX، نقدینگی و اسلیپیج کنار قیمت CEX

به طور خلاصه

  • API DEX قیمت توکن در استخر، نقدینگی، حجم، ارزش بازار، قرارداد و شبکه را برمی‌گرداند. برای آربیتراژ قیمت CEX همان قرارداد را هم لازم دارید؛ اندپوینت‌های DEX – Spot و DEX – Futures در Genesis API آن را در پلن‌های Pro و Max برمی‌گردانند.
  • قیمت DEX به حجم معامله بستگی دارد، چون استخر نقدینگی آن را تعیین می‌کند. در یک مثال فرضی، اسپرد 3% در معامله 2,500 دلاری 11 دلار باقی می‌گذارد و در 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 دلار و حجم 24 ساعتهٔ DEX حدود 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% و آنچه از آن می‌ماند

توکن در DEX یک دلار و در CEX 1.03 دلار است: اسپرد 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 در برابر اسپات 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ها و اینکه توکن در 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 به‌جای exchange پارامتر chain را می‌گیرد، و 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 خوانده می‌شود.

تابع درخواست در 429 و 503 به‌اندازهٔ Retry-After ثانیه صبر می‌کند. وقتی سهمیهٔ ماهانه تمام شود، 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» چاپ می‌کند تا دستی بررسی‌شان کنید.

برای داده‌های DEX به کدام پلن Genesis API نیاز دارم؟

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 هستند.