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اسپرد بین بازارهای اسپات CEXTrial, 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 در برابر فیوچرز CEXPro, 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ارزش بازار و حجم 24 ساعته DEX (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 نام آن در هر صرافی: در مثال نفت برنت در MEXC با UKOIL و در Ourbit با BRENTOIL معامله می‌شود. ابزار را در صرافی با 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 آربیتراژ سهام را اضافه می‌کند.