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 قیمت با جریان سفارشها در دفتر حرکت میکند. شکاف تا وقتی آربیتراژگر آن را ببندد میماند، و اینها مانع میشوند:
- واریز یا برداشت بسته است. اگر توکن را نشود به صرافی یا از آن منتقل کرد، دو بازار جدا از هم زندگی میکنند. در ردیف این همان
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% و آنچه از آن میماند
توکن در 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_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 بهجای 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 را بدون رسیدن به محدودیتها پرسوجو کنیم آمده است.
ریسکهایی که اسپرد نشان نمیدهد
- 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» چاپ میکند تا دستی بررسیشان کنید.
برای دادههای 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 هستند.