Genesis Arbitrage

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

داده 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-spotwithdraw_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-interestdirection، 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 Δبه دلار
00.4002 → 0.40581.3993%—
500 دلار0.4004 → 0.40551.2737%6.37 دلار
2,500 دلار0.4012 → 0.40410.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-trafficdirection، target، total_usdStart، Pro، Max
آنلاک توکن‌ها/onchain/unlocksunlock_value_usd، hours_leftStart، Pro، Max
اوپن اینترست به تفکیک صرافی/market/open-interestoi_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 است.

تمرین

  1. یک جفت بردارید

    در مستندات Spot — Spot فرم «امتحان درخواست» را باز کنید، کلید خود را بچسبانید و ردیفی با اسپرد 1% یا بیشتر را انتخاب کنید.

  2. نقطه‌های 1 و 2 را بررسی کنید

    دو کارمزد فرضی 0.1% را از spread_pct کم کنید و withdraw_enabled_buy و deposit_enabled_sell را ببینید. contract را با پاسخ /coins/search برای این کوین مقایسه کنید.

  3. نقطه 3 را بررسی کنید

    در Pro یا Max، /orderbooks/spreads/spot-spot را با این کوین و volume=1000 درخواست کنید و ردیفی با همان جفت صرافی را پیدا کنید. در Trial و Start دفتر سفارش را در ترمینال صرافی باز کنید.

  4. نقطه 4 را بررسی کنید

    meta.updated_at را از زمان unix کنونی کم کنید: date +%s آن را در ترمینال چاپ می‌کند.

  5. حکم را بنویسید

    کدام نقطه جفت را زودتر رد می‌کرد و روی 1,000 دلار چه مقدار از اسپرد می‌ماند.

پرسش و پاسخ

برای آربیتراژ ارز دیجیتال چه داده‌ای لازم است؟

قیمت کوین در صرافی‌های مختلف و اسپرد بین آن‌ها، وضعیت واریز و برداشت به‌همراه شبکه و قرارداد، دفترهای سفارش برای محاسبه اجرا با حجم شما و زمان اسنپ‌شات. آربیتراژ فاندینگ نرخ‌ها، بازه‌ها و زمان پرداخت را هم اضافه می‌کند. در Genesis API این‌ها /arbitrage/*، /orderbooks/* و /funding/* هستند.

آیا می‌شود از طریق Genesis API معامله انجام داد؟

نه. Genesis API فقط داده می‌خواند و سفارش ثبت نمی‌کند: معامله‌ها را خودتان در صرافی‌ها باز می‌کنید.