داده API برای آربیتراژ: اسپردها، دفتر سفارش و فاندینگ
به طور خلاصه
- هر پرسش معاملهگر اندپوینت خودش را دارد: اختلاف قیمت
spread_pctدر/arbitrage/*است، انتقال کوین پرچمهای واریز و برداشت بههمراهnetworkوcontractاست، اجرا برای حجم شما/orderbooks/*و حالت فاندینگ/funding/*است. - اسپرد ردیف از آخرین معاملات محاسبه میشود. در مثال توضیحی، 1.5% روی 2,500 دلار پس از عبور از دفترهای سفارش به 0.72% و پس از دو کارمزد taker معادل 0.1% به حدود 0.52% میرسد، یعنی نزدیک به 13 دلار.
- هر پاسخ زمان خودش را دارد:
meta.updated_atزمان ساخت اسنپشات است،meta.freshness_secگام بهروزرسانی پلن شماست وage_secوstaleسن دفتر سفارش را نشان میدهند. - جفتارز در چهار نقطه بررسی میشود: اختلاف قیمت، انتقال، دفتر سفارش و تازگی. ردشدن در هر یک از آنها ورود را لغو میکند.
- آربیتراژ CEX، فاندینگ و اوپن اینترست در همه پلنهای Genesis API هست، بخشهای آنچین از Start شروع میشوند و دفترهای سفارش و داده DEX با Pro و Max میآیند.
داده آربیتراژ ارز دیجیتال به پنج پرسش پاسخ میدهد: آیا اختلاف قیمت هست، آیا میتوانید کوین را منتقل کنید، آیا دفتر سفارش برای حجم شما بهاندازه کافی عمیق است، آیا فاندینگ پرداخت میکند و بازیگران بزرگ چه میکنند. در Genesis API هر پرسش اندپوینت و چند فیلد پاسخ مخصوص خود را دارد. اولین درخواست و پوشش success، data، meta در درس 2 آمده است؛ این درس درباره این است که کدام فیلدها را و به چه ترتیبی بخوانید.
پرسش معاملهگر ← اندپوینت ← فیلدها
| پرسش | اندپوینت | فیلدها |
|---|---|---|
| آیا اختلاف قیمت هست | /arbitrage/* | spread_pct، price_buy، price_sell |
| آیا میتوانید کوین را منتقل کنید | همان ردیف /arbitrage/spot-spot | withdraw_enabled_buy، deposit_enabled_sell، network، contract |
| آیا دفتر بهاندازه کافی عمیق است | /orderbooks/* | order_delta.spread_pct، order_delta.status |
| آیا فاندینگ پرداخت میکند | /funding/* | spread_pct، interval_1، interval_2، next_payout_1 |
| بازیگران بزرگ چه میکنند | /onchain/*، /market/open-interest | direction، total_usd، oi_change_1h |
ستاره نشانه یک گروه است: /arbitrage/* هفت اندپوینت دارد، از Spot – Spot تا سهام، و /orderbooks/* و /funding/* هر کدام شش. بخشهای زیر به همان ترتیبی هستند که جفتارز را بررسی میکنید.
آیا اختلاف قیمت هست: spread_pct
ردیفی از مستندات Spot — Spot: FUEL، خرید در ByBit به قیمت 0.0007029، فروش در Gate به قیمت 0.0007037، و spread_pct برابر 0.11. بررسی: (0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%. اسپرد ردیف از price_buy و price_sell محاسبه میشود که قیمت آخرین معاملهاند؛ در سایت این همان ستون قیمت است.
در مجموعههای DEX – Spot و DEX – Futures علامت اهمیت دارد: مثبت یعنی توکن در DEX ارزانتر است و منفی یعنی گرانتر. پارامترها و فیلدهای هر هفت مجموعه در راهنمای اندپوینتهای آربیتراژ است.
spread_pct فقط به پرسش اول پاسخ میدهد: کارمزد، انتقال و دفتر سفارش در آن نیست.
آیا میتوانید کوین را منتقل کنید: واریز، برداشت، شبکه و قرارداد
جفت اسپات بین دو صرافی به انتقال نیاز دارد: کوین را در یک صرافی میخرید، برداشت میکنید و در صرافی دیگر واریز میکنید. پس در ردیف دو پرچم برای خواندن هست: withdraw_enabled_buy یعنی برداشت در صرافی خرید باز است یا نه، و deposit_enabled_sell یعنی واریز در صرافی فروش باز است یا نه. درخواست برای آنها پارامتری ندارد، پس کد شما ردیفها را فیلتر میکند.
network و contract نشان میدهند که توکن همان است یا نه. ارزهای متفاوت میتوانند در صرافیهای مختلف زیر یک نماد معامله شوند، پس آدرس قرارداد را با صفحههای برداشت و واریز هر دو صرافی مقایسه کنید. قراردادهای یک کوین در هر شبکه و صرافیهایی که از هر کدام استفاده میکنند از /coins/search در هر پلنی به دست میآید (Coin Search).
در مجموعههای DEX پرچمها به سمت CEX تعلق دارند: deposit_enabled و withdraw_enabled. در Cross-chain توکن از طریق یک پل بین شبکههای buy.chain و sell.chain جابهجا میشود، پس پرچم صرافی وجود ندارد.
آیا دفتر سفارش بهاندازه کافی عمیق است: اسپرد ردیف در برابر اسپرد پس از اجرا
سفارش بازار از دفتر سفارش عبور میکند: خرید از بهترین قیمت فروش رو به بالا میگیرد و فروش از بهترین قیمت خرید رو به پایین. هر چه حجم بزرگتر باشد، میانگین قیمت بدتر میشود و از اسپرد ردیف کمتر میماند. Order-book Δ، یعنی /orderbooks/spreads/{dataset} در پلنهای Pro و Max، همان چیزی را برمیگرداند که برای حجم شما میماند (مستندات).
مثال توضیحی: کوین LMN، خرید در OKX به قیمت 0.4000، فروش در Bitget به قیمت 0.4060. اسپرد ردیف: (0.4060 − 0.4000) / 0.4000 × 100 = 1.5%. درخواست /orderbooks/spreads/spot-spot با coin=LMN برای مقادیر مختلف volume:
| حجم | خرید ← فروش | Order-book Δ | به دلار |
|---|---|---|---|
0 | 0.4002 → 0.4058 | 1.3993% | — |
| 500 دلار | 0.4004 → 0.4055 | 1.2737% | 6.37 دلار |
| 2,500 دلار | 0.4012 → 0.4041 | 0.7228% | 18.07 دلار |
| 10,000 دلار | — | exhausted | — |
volume=0 از بهترین ask در OKX و بهترین bid در Bitget استفاده میکند: بهترین سفارشها بدتر از آخرین معاملاتاند، پس حتی با کوچکترین حجم 0.1 واحد درصد از دست میرود. در 2,500 دلار میانگین قیمت خرید 0.4012 و میانگین قیمت فروش 0.4041 است: (0.4041 − 0.4012) / 0.4012 × 100 ≈ 0.7228%. در 10,000 دلار bidهای Bitget تمام شدند و order_delta.status برابر exhausted است.
هر صرافی کارمزد taker میگیرد؛ مثال 0.1% فرض میکند (maker و taker). در 2,500 دلار برایتان 0.7228 − 2 × 0.1 = 0.5228% میماند، یعنی 2,500 × 0.5228 / 100 ≈ 13.07 دلار. کارمزد برداشت در پاسخها نیست: آن را در صفحه برداشت صرافی ببینید و جداگانه کم کنید.
در Trial و Start اندپوینتهای دفتر سفارش 403 plan_restricted برمیگردانند، پس دفتر را در ترمینال صرافی بررسی میکنید. قیمت اجرا و لغزش قیمت در API دفتر سفارش ارز دیجیتال توضیح داده شده و هر شش اندپوینت در راهنمای اندپوینتهای دفتر سفارش.
آیا فاندینگ پرداخت میکند: اسپرد، بازهها و زمان پرداخت
آربیتراژ فاندینگ یعنی شورت در جایی که نرخ فاندینگ بالاتر است و لانگ در جایی که پایینتر است: حرکت قیمت بهندرت نتیجه را عوض میکند و اختلاف نرخ انباشته میشود. کاندیداها از /funding/spread در هر پلنی میآیند: بهترین جفت صرافی در best و spread_pct آن (Funding spread).
اسپرد جفت نمیگوید پرداختها کی و هر چند وقت یک بار انجام میشوند. interval_1 و interval_2 بازههای فاندینگ دو صرافیاند و next_payout_1 و next_payout_2 زمان پرداخت بعدی به UTC: فقط پوزیشنی که لحظه تسویه باز باشد فاندینگ میگیرد. نرخهایی با بازههای متفاوت پس از نرمالسازی به 8 ساعت مقایسه میشوند که همان فیلد funding_8h_pct در /funding/rates است.
مثال توضیحی: اسپرد 0.03% در هر 8 ساعت، با پوزیشن 5,000 دلاری روی هر پا. یک تسویه 5,000 × 0.03 / 100 = 1.5 دلار میآورد. چهار معامله، یعنی باز و بسته کردن هر دو پا، با کارمزد taker معادل 0.1% هزینهای برابر 4 × 5,000 × 0.1 / 100 = 20 دلار دارد. کارمزدها پس از 20 / 1.5 ≈ 13.3 تسویه جبران میشوند: یعنی 14 تسویه هشتساعته، نزدیک به پنج روز، اگر نرخها بمانند.
تاریخچه نشان میدهد اختلاف پایدار است یا نه: در Pro و Max، /funding/analytics/summary با coin برای هر صرافی و هر دوره sum (فاندینگ انباشته)، cov (پوشش) و flips (تغییر علامت) را برمیگرداند. جزئیات در API نرخ فاندینگ و راهنمای اندپوینتهای فاندینگ است.
بازیگران بزرگ چه میکنند: آنچین و اوپن اینترست
داده آنچین و اوپن اینترست توضیح میدهند چرا ممکن است جفتارز پیش از اجرای شما بسته شود. جریان کوین به صرافی فروش یعنی فروشندگانی که پیش از انتقال شما میرسند. افزایش اوپن اینترست یعنی پوزیشنهای اهرمی تازه، و حرکت تند خلاف آنها لیکوئید شدنها را به راه میاندازد.
| آنچه میبینید | درخواست | فیلدها | پلنها |
|---|---|---|---|
| جریان کوین به صرافیها و از آنها | /onchain/coin-traffic | direction، target، total_usd | Start، Pro، Max |
| آنلاک توکنها | /onchain/unlocks | unlock_value_usd، hours_left | Start، Pro، Max |
| اوپن اینترست به تفکیک صرافی | /market/open-interest | oi_usd، oi_change_1h، price_change_1h | همه |
نمونه پاسخ در مستندات Genesis Onchain 18 انتقال LAB به Gate به ارزش 573,796.98 دلار را در 5.69 ساعت نشان میدهد و direction برابر deposit است. اگر LAB در آن لحظه جفتی داشته باشد که در Gate فروخته میشود، چنین جریانی دلیلی است برای کم کردن حجم یا رد کردن ورود. بیشتر در API داده آنچین و API اوپن اینترست.
تازگی داده و مهر زمانی
هر پاسخ زمان خودش را دارد: meta.updated_at زمان unix ساخت اسنپشات است و meta.freshness_sec گام بهروزرسانی پلن شما: 60 ثانیه در Trial، 30 در Start، 10 در Pro و 5 در Max. سن اسنپشات برابر زمان کنونی منهای updated_at است (تازگی داده).
مثال توضیحی: پلن Trial، پاسخ در 1783802455 رسید و updated_at برابر 1783802410 است. سن اسنپشات 1783802455 − 1783802410 = 45 ثانیه است: جفتهایش از قیمتهای نزدیک به یک دقیقه قبل محاسبه شدهاند و ممکن است برخی از آنها در صرافیها دیگر نباشند.
دفترهای سفارش ساعت خودشان را دارند: در /orderbooks/book و /orderbooks/coin/{coin} هر دفتر book_ts، age_sec (سنش به ثانیه) و stale: true دارد وقتی از 30 ثانیه قدیمیتر باشد. دفترها 5 تا 20 ثانیه از صرافی عقباند، پس سن دفتر هر دو پا را بررسی کنید: اختلاف قیمت بین یک دفتر تازه و یک دفتر قدیمی ممکن است اختلاف زمان باشد.
چرا یک فیلد کافی نیست: بررسی چهارنقطهای
هر فیلد یک پرسش را میبندد و فقط وقتی همه بسته شدند میتوانید وارد شوید. اسپرد 3% با برداشت بسته یعنی کوین روی صرافی خرید گیر میکند. با exhausted حجم شما پر نخواهد شد. با اسنپشاتی که 50 ثانیه قدمت دارد ممکن است جفت دیگر وجود نداشته باشد.
| نقطه | فیلدها | جفت رد میشود اگر |
|---|---|---|
| 1. اختلاف قیمت | spread_pct | اسپرد منهای دو کارمزد کمتر از آستانه باشد |
| 2. انتقال | withdraw_enabled_buy، deposit_enabled_sell، contract | برداشت یا واریز بسته باشد یا قرارداد نخواند |
| 3. دفتر سفارش | order_delta.status، order_delta.spread_pct | وضعیت ok نباشد یا باقیمانده کمتر از آستانه باشد |
| 4. تازگی | meta.updated_at، age_sec، stale | اسنپشات یا یک دفتر از آستانه قدیمیتر باشد |
تابع یک ردیف data از /arbitrage/spot-spot، شیء order_delta همان جفت صرافی (در Trial و Start برابر None) و meta پاسخ را میگیرد. آستانهها توضیحیاند: آنها را با کارمزد و پلن خود تنظیم کنید.
import time
FEE = 0.1 # assumed taker fee per leg, %
MIN_NET = 0.3 # at least 0.3% left after fees
MAX_AGE = 60 # snapshot no older than 60 seconds
def check(row, od, meta):
"""The points a Spot – Spot pair failed."""
fails = []
if row["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("1: spread does not cover the fees")
if not row["withdraw_enabled_buy"]:
fails.append("2: withdrawals closed on the buy exchange")
if not row["deposit_enabled_sell"]:
fails.append("2: deposits closed on the sell exchange")
if od is None:
fails.append("3: book not checked (Trial or Start)")
elif od["status"] != "ok":
fails.append("3: book — " + od["status"])
elif od["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("3: too little left after the book")
if time.time() - meta["updated_at"] > MAX_AGE:
fails.append("4: snapshot older than MAX_AGE seconds")
return fails
فهرست خالی یعنی جفت از هر چهار نقطه گذشته است. جفت LMN در 2,500 دلار میگذرد: 1.5 − 0.2 = 1.3% روی ردیف، 0.7228 − 0.2 = 0.5228% پس از دفتر و اسنپشاتی با سن 45 ثانیه. در 10,000 دلار تابع "3: book — exhausted" برمیگرداند. کد نمیتواند قرارداد را تأیید کند: آدرس را در صفحههای برداشت و واریز صرافیها خودتان بررسی میکنید و سن دفتر هر دو پا از /orderbooks/book میآید.
همین بررسی روی جدول سایت، بدون کد، در درس اسپرد، عمق، حجم — خواندن جدول است و پرسوجوی API در یک حلقه در درس 4.
کدام داده با کدام پلن میآید
| پلن | تازگی | داده آربیتراژ |
|---|---|---|
| Trial، 20 دلار در ماه | 60 ث | Spot – Spot، Spot – Futures، Futures – Futures، نرخ و اسپرد فاندینگ، اوپن اینترست، Fair – Last، پامپها، جستجوی کوین |
| Start، 50 دلار | 30 ث | همه موارد Trial بهعلاوه سهام، بخشهای آنچین /onchain/{section}، آربیتراژ پیشبینی در حالتهای exact و dutch |
| Pro، 100 دلار | 10 ث | همه اندپوینتها: دفترهای سفارش و Order-book Δ، DEX – Spot، DEX – Futures، Cross-chain، تحلیل فاندینگ |
| Max، 200 دلار | 5 ث | همان اندپوینتهای Pro، با 15 درخواست در ثانیه |
اندپوینتی بیرون از پلن شما 403 plan_restricted برمیگرداند و این پاسخ از سهمیه کم نمیکند. سهمیه درخواستها و محدودیت درخواست در ثانیه در صفحه قیمت Genesis API است.
تمرین
یک جفت بردارید
در مستندات Spot — Spot فرم «امتحان درخواست» را باز کنید، کلید خود را بچسبانید و ردیفی با اسپرد 1% یا بیشتر را انتخاب کنید.
نقطههای 1 و 2 را بررسی کنید
دو کارمزد فرضی 0.1% را از
spread_pctکم کنید وwithdraw_enabled_buyوdeposit_enabled_sellرا ببینید.contractرا با پاسخ/coins/searchبرای این کوین مقایسه کنید.نقطه 3 را بررسی کنید
در Pro یا Max،
/orderbooks/spreads/spot-spotرا با این کوین وvolume=1000درخواست کنید و ردیفی با همان جفت صرافی را پیدا کنید. در Trial و Start دفتر سفارش را در ترمینال صرافی باز کنید.نقطه 4 را بررسی کنید
meta.updated_atرا از زمان unix کنونی کم کنید:date +%sآن را در ترمینال چاپ میکند.حکم را بنویسید
کدام نقطه جفت را زودتر رد میکرد و روی 1,000 دلار چه مقدار از اسپرد میماند.
پرسش و پاسخ
برای آربیتراژ ارز دیجیتال چه دادهای لازم است؟
قیمت کوین در صرافیهای مختلف و اسپرد بین آنها، وضعیت واریز و برداشت بههمراه شبکه و قرارداد، دفترهای سفارش برای محاسبه اجرا با حجم شما و زمان اسنپشات. آربیتراژ فاندینگ نرخها، بازهها و زمان پرداخت را هم اضافه میکند. در Genesis API اینها /arbitrage/*، /orderbooks/* و /funding/* هستند.
آیا میشود از طریق Genesis API معامله انجام داد؟
نه. Genesis API فقط داده میخواند و سفارش ثبت نمیکند: معاملهها را خودتان در صرافیها باز میکنید.