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