Genesis Arbitrage

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

API ارز دیجیتال چیست و چه چیزی را می‌توان خودکار کرد

به طور خلاصه

  • API ارز دیجیتال یک رابط برنامه‌نویسی است که برنامه شما برای درخواست داده‌های بازار و دریافت پاسخ JSON از آن استفاده می‌کند: همان اسپرد جدول سایت، در قالب فیلدهای exchange_buy، exchange_sell و spread_pct.
  • API صرافی داده و حساب یک صرافی را پوشش می‌دهد، API داده بازار چند صرافی را در یک قالب جمع می‌کند و API آن‌چین بلاکچین را می‌خواند. Genesis API یک API داده بازار فقط‌خواندنی است.
  • با API، معامله‌گران پایش اسپرد، نرخ فاندینگ و اوپن اینترست، هشدارها، دفتر ثبت سیگنال، داشبوردها و پژوهش روی داده‌های تاریخی را خودکار می‌کنند.
  • بدون تجربه، اجرای معامله و برداشت را دستی نگه دارید: اسنپ‌شات داده از صرافی عقب است و باگ کد شما در هر چرخه تکرار می‌شود.

API ارز دیجیتال یک رابط برنامه‌نویسی است که کد شما با آن داده‌های بازار ارز دیجیتال را درخواست می‌کند و پاسخی قابل‌پردازش می‌گیرد: قیمت‌ها، اسپرد بین صرافی‌ها، نرخ فاندینگ، اوپن اینترست. انسان این اعداد را در جدول می‌خواند؛ برنامه آن‌ها را به‌شکل فیلدهای JSON دریافت می‌کند و می‌تواند بلافاصله با یک آستانه مقایسه‌شان کند، ثبتشان کند یا هشدار بفرستد. تعریف کلی در مدخل واژه‌نامه API آمده است.

درخواست و پاسخ

کار با API تبادل دو پیام است: برنامه شما درخواستی به یک نشانی می‌فرستد و سرور پاسخ برمی‌گرداند. کوتاه‌ترین نمونه، بررسی وضعیت Genesis API است که کلید نمی‌خواهد:

curl "https://api.genesisarbitrage.com/health"
{"ok":true}

curl برنامه‌ای خط فرمان برای درخواست‌های HTTP است؛ با curl --version می‌فهمید نصب است یا نه. درخواست‌های داده به کلید API نیاز دارند؛ رشته‌ای که سرور با آن حساب و پلن شما را می‌شناسد. نمونه توضیحی: جفت‌های Spot – Spot برای ارز FUEL، با کلیدی که از متغیر محیطی GENESIS_API_KEY گرفته می‌شود:

URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
  "success": true,
  "data": [
    {
      "coin": "FUEL",
      "exchange_buy": "ByBit",
      "exchange_sell": "Gate",
      "price_buy": 0.0007029,
      "price_sell": 0.0007037,
      "spread_pct": 0.11,
      "withdraw_enabled_buy": true,
      "deposit_enabled_sell": true,
      …
    }
  ],
  "meta": {
    "count": 1,
    "updated_at": 1794675861,
    "freshness_sec": 60,
    "plan": "trial"
  }
}

پاسخ یک جفت دارد: خرید FUEL در ByBit با قیمت 0.0007029 و فروش آن در Gate با قیمت 0.0007037. اسپرد از قبل در spread_pct محاسبه شده است: (0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%. پرچم‌های withdraw_enabled_buy و deposit_enabled_sell نشان می‌دهند که برداشت از ByBit و واریز به Gate باز است و meta.updated_at می‌گوید اسنپ‌شات چه زمانی ساخته شده. جدول Spot – Spot همین اعداد را نشان می‌دهد و هر فیلد در بخش Spot — Spot مستندات توضیح داده شده است.

نشانی درخواست از یک آدرس پایه، مسیر اندپوینت و پارامترها ساخته می‌شود و کلید جداگانه در هدر X-API-Key می‌رود. درس 2 هر بخش درخواست را باز می‌کند، کدهای وضعیت و خواندن JSON را توضیح می‌دهد و نشان می‌دهد متغیر کلید را چطور تنظیم کنید.

این نوع تبادل، یعنی درخواست و بعد پاسخ با اسنپ‌شاتی از داده، REST API نام دارد. داده تازه را با فرستادن دوباره درخواست می‌گیرید: Genesis API خروجی خود را هر meta.freshness_sec ثانیه به‌روز می‌کند، از 60 در Trial تا 5 در Max. صرافی‌ها کانال دومی هم دارند، WebSocket: اتصال باز می‌ماند و سرور معاملات و تغییرات دفتر سفارش را همان لحظه می‌فرستد، مثل استریم‌های Binance. Genesis API وب‌سوکت ندارد.

انواع API ارز دیجیتال

API‌های ارز دیجیتال از نظر منبع داده و کارهایی که با آن‌ها می‌شود انجام داد فرق دارند:

مقایسه شش نوع API، تفاوت REST و WebSocket و چک‌لیست نُه‌مرحله‌ای انتخاب در مقاله انواع API ارز دیجیتال و نحوه انتخاب آمده است.

معامله‌گر چه چیزی را می‌تواند خودکار کند

چیزی را خودکار کنید که با قاعده‌ای ثابت تکرار می‌کنید: باز کردن جدول، مقایسه عدد با آستانه، ثبت نتیجه. برنامه این کار را طبق زمان‌بندی انجام می‌دهد و ساعت‌های شب را از دست نمی‌دهد.

کاربرنامه چه می‌کندداده Genesis API
پایش اسپردجفت‌های بالاتر از آستانه با واریز و برداشت باز/arbitrage/spot-spot، /arbitrage/spot-futures
نرخ فاندینگنرخ صرافی‌های نرمال‌شده به 8 ساعت را مقایسه می‌کند/funding/rates، /funding/spread
اوپن اینترستتغییرات ناگهانی OI را در بازه 5 دقیقه تا 1 ساعت می‌گیرد/market/open-interest
هشدارهابا برقرار شدن شرط در تلگرام پیام می‌دهدهر اندپوینت داده
دفتر ثبتهر جفت یافت‌شده را با زمان ذخیره می‌کندپاسخ و meta.updated_at
داشبوردستون‌ها و آستانه‌های شما را در صفحه خودتان نشان می‌دهددرخواست‌ها از سرور شما
پژوهش تاریخیالگوها را در داده‌های گذشته جست‌وجو می‌کند/funding/analytics/daily (Pro، Max)

هشدار اغلب اولین پروژه است: برنامه اندپوینت را حداکثر هر meta.freshness_sec ثانیه یک بار می‌خواند و وقتی اسپرد یا نرخ از آستانه شما رد شود پیام می‌دهد. بدون کد، سیگنال‌های مشابه را هشدارهای تلگرام Genesis Arbitrage در پلن Pro سایت می‌دهند.

دفتر ثبت پیش از آنکه پولی در خطر باشد یک ایده را می‌آزماید. نمونه توضیحی: رباتی هر 30 ثانیه جفت‌های با اسپرد 1% یا بیشتر را ثبت می‌کند، یعنی 86,400 / 30 = 2,880 اسنپ‌شات در روز. این اسنپ‌شات‌ها نشان می‌دهند چند جفت بیش از یک دقیقه ماندند و چند جفت تا نظرسنجی بعدی از بین رفتند.

برای تاریخچه، Genesis API تحلیل فاندینگ را دارد، یعنی مجموع روزانه فاندینگ تسویه‌شده تا یک سال در 13 صرافی، و تاریخچه اسلیپیج دفتر سفارش؛ هر دو در پلن‌های Pro و Max هستند. Genesis API کندل تاریخی ندارد: آن را API صرافی‌ها می‌دهند، در Binance با GET /api/v3/klines تا 1,000 کندل در هر درخواست (مستندات Binance). تاریخچه اسپرد بین صرافی‌ها را برنامه خودتان از اسنپ‌شات‌های دفتر ثبت می‌سازد.

چه چیزی را بدون تجربه خودکار نکنید

دو عملیات اگر خطا کنند گران تمام می‌شوند: اجرای معامله و برداشت.

اجرای معامله

رباتی که از طریق API معاملاتی صرافی سفارش می‌گذارد، به همان اندازه که اجرا می‌شود خطا هم می‌کند: باگ در شرط ورود با نظرسنجی هر 10 ثانیه در ساعت 3,600 / 10 = 360 سفارش می‌سازد. داده هم عقب است: اسنپ‌شات Genesis API بسته به پلن هر 60 تا 5 ثانیه به‌روز می‌شود، دفترهای سفارش 5–20 ثانیه از صرافی عقب‌اند و اسپرد ممکن است در همین مدت بسته شود. Genesis API سفارش نمی‌گذارد: جفت‌ها را پیدا می‌کند و معامله را خودتان در صرافی باز می‌کنید.

برداشت

کلید صرافی با مجوز برداشت به هر کسی که به آن دست یابد اجازه می‌دهد پول را از حساب خارج کند، پس لو رفتن چنین کلیدی می‌تواند کل موجودی را هزینه کند. رباتی که داده می‌خواند یا معامله می‌کند به این مجوز نیاز ندارد. در Binance کلید جدید به‌طور پیش‌فرض حتی نمی‌تواند معامله کند: مجوز معامله جداگانه فعال می‌شود.

سایت، API صرافی‌ها یا Genesis API

کارگزینه مناسب‌تردلیل
مرور جفت‌ها و نمودارهاسایت Genesis Arbitrageجدول و فیلتر، بدون کد
سیگنال بدون برنامه‌نویسیهشدارهای تلگرام در سایتآستانه‌ها در رابط تنظیم می‌شوند
قواعد خودتان در 20+ صرافیGenesis APIاسپردها محاسبه‌شده، یک قالب
سفارش، موجودی، برداشتAPI صرافیفقط صرافی سفارش می‌پذیرد
هر معامله به‌صورت لحظه‌ایWebSocket صرافیGenesis API هر 60–5 ثانیه اسنپ‌شات می‌دهد
کندل‌های گذشتهAPI صرافیGenesis API کندل ندارد
تاریخچه فاندینگ در 13 صرافیGenesis API، پلن‌های Pro و Maxتا یک سال مجموع روزانه در یک قالب

یک ترکیب عملی برای شروع: Genesis API جفتی پیدا می‌کند، ربات شما هشدار می‌فرستد و شما دفتر سفارش صرافی را بررسی می‌کنید و معامله را خودتان باز می‌کنید. پلن‌های Genesis API از Trial با 20 دلار در ماه (500K فراخوانی، تازگی 60 ثانیه) تا Max با 200 دلار (10M فراخوانی، 5 ثانیه) هستند و پلن رایگان وجود ندارد. آن‌ها را در صفحه تعرفه‌های Genesis API مقایسه کنید.

برای بقیه دوره چه چیزی لازم دارید

درس‌ها روی هم بنا می‌شوند:

خودتان امتحان کنید

  1. درخواستی بدون کلید بفرستید

    در ترمینال curl "https://api.genesisarbitrage.com/health" را اجرا کنید. پاسخ {"ok":true} یعنی درخواست رسیده و سرور با JSON جواب داده است.

  2. جدول را با فیلدها تطبیق دهید

    جدول Spot – Spot و بخش Spot — Spot مستندات را باز کنید. فیلدهای صرافی‌ها، قیمت‌ها، اسپرد و وضعیت انتقال را پیدا کنید: exchange_buy، price_sell، spread_pct، withdraw_enabled_buy.

  3. کارهای روتین خود را فهرست کنید

    سه کاری را که هر روز انجام می‌دهید بردارید و هرکدام را با جدول بالا برچسب بزنید: سایت، Genesis API یا API صرافی.

  4. اندپوینت یک کار را پیدا کنید

    برای یکی از کارهای Genesis API، اندپوینت را در مستندات پیدا کنید و پارامترهای لازم را یادداشت کنید، مثل coin و min_spread. این درخواست را در درس 2 می‌فرستید.