Genesis Arbitrage

Genesis Arbitrage · · به‌روزرسانی · 5 دقیقه مطالعه

شروع سریع Genesis API: کلید، اولین درخواست و محدودیت‌ها

به طور خلاصه

  • Genesis API دسترسی REST به داده‌های Genesis Arbitrage است: اسپردهای CEX و DEX، دفتر سفارش‌ها، فاندینگ، کراس‌چین، جریان‌های آن‌چین، بازارهای پیش‌بینی و سیگنال‌های Genesis AI+.
  • رسیدن به اولین درخواست سه مرحله دارد: یک پلن، یک کلید در پروفایل و یک درخواست GET با هدر X-API-Key.
  • پلن شما سهمیه فراخوانی، درخواست در ثانیه و تأخیر داده را تعیین می‌کند — از 60 ثانیه در Trial تا 5 ثانیه در Max.

Genesis API داده‌های Genesis Arbitrage را به‌صورت REST API ارائه می‌کند: اسپردهای بین CEX و DEX، دفتر سفارش‌ها، فاندینگ، کراس‌چین، جریان‌های آن‌چین، بازارهای پیش‌بینی و سیگنال‌های Genesis AI+. هر ابزار سایت یک endpoint جداگانه با یک قالب JSON یکسان دارد. اولین درخواست شما یک پلن API، یک کلید و یک هدر HTTP لازم دارد — هیچ SDK ای لازم نیست و هر زبانی که کلاینت HTTP داشته باشد کافی است.

شروع سریع Genesis API: کلید، اولین درخواست و محدودیت‌ها
نمای آن در Genesis Arbitrage

API چه چیزهایی را پوشش می‌دهد

endpointها بخش‌های سایت را بازتاب می‌دهند:

مجموعه‌های داده در صفحه Genesis API توضیح داده شده‌اند؛ پارامترها و فیلدهای هر endpoint در مستندات است.

پلن‌ها و محدودیت‌ها

API پلن‌های مخصوص خود را دارد که از اشتراک سایت جداست: Trial، Start، Pro و Max. در سهمیه فراخوانی، محدودیت درخواست در ثانیه و تازگی داده با هم فرق دارند.

پلن APIفراخوانی در ماهتازگی داده
Trial500 هزار60 ثانیه
Start2 میلیون30 ثانیه
Pro5 میلیون10 ثانیه
Max10 میلیون5 ثانیه

Trial ماهانه 20 $ هزینه دارد و Max اجازه 15 درخواست در ثانیه را می‌دهد. endpointهایی که جزو پلن شما نیستند خطای 403 با کد plan_restricted برمی‌گردانند. درخواست‌های بیش از محدودیت‌ها هزینه‌ای ندارند: منتظر دوره جدید بمانید یا ارتقا دهید. فقط پاسخ‌های 200 از سهمیه مصرف می‌کنند: خطاها و پاسخ‌های 304 رایگان‌اند. قیمت‌ها و مقایسه کامل در صفحه تعرفه‌های Genesis API است.

اولین درخواست شما

  1. یک پلن انتخاب کنید

    در صفحه تعرفه‌های Genesis API یک پلن و دوره انتخاب کنید و روی «خرید اشتراک» کلیک کنید. پرداخت با کریپتو است، درست مثل اشتراک سایت. اگر پلن API دیگری از قبل فعال باشد، پرداخت پلن جدید آن را جایگزین می‌کند و باقی‌مانده از دست می‌رود — سایت پیش از آن هشدار می‌دهد.

  2. کلید خود را بگیرید

    در پروفایل، در بخش Genesis API، روی «دریافت کلید» کلیک کنید. یک کلید gns_live_… در پنجره «کلید API شما» ظاهر می‌شود — روی «کپی» کلیک کنید و ذخیره‌اش کنید. فقط یک بار نمایش داده می‌شود.

  3. درخواست بفرستید

    یک HTTP GET ساده بفرستید و کلید را در هدر X-API-Key بدهید. آدرس پایه https://api.genesisarbitrage.com/v1 است. endpoint خوبی برای اولین بار /account/usage است — پلن شما و سهمیه باقی‌مانده را نشان می‌دهد.

  4. پاسخ را تحلیل کنید

    پاسخ موفق در یک پوشش واحد می‌آید: آرایه data و بلوک meta. اگر مشکلی پیش آمد، جدول خطاهای زیر را ببینید.

یک نمونه curl:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

مستندات فرم «امتحان درخواست» دارد: کلید را بچسبانید، روی «ارسال درخواست» کلیک کنید و پاسخی خلاصه‌شده را همان‌جا در صفحه ببینید. کلید فقط در مرورگر شما ذخیره می‌شود.

قالب پاسخ

خطاها و محدودیت‌ها

کدمعنا
401کلید وجود ندارد، نامعتبر است یا لغو شده است
403endpoint جزو پلن شما نیست
404endpoint یا منبع پیدا نشد
429از محدودیت نرخ فراتر رفته‌اید — هدرهای X-RateLimit و Retry-After را ببینید
500خطای داخلی، بعداً دوباره تلاش کنید
503داده‌ها در حال بازسازی است، چند ثانیه بعد دوباره تلاش کنید — Retry-After را ببینید

هدرهای X-RateLimit در هر پاسخ محدودیت درخواست در ثانیه، تعداد درخواست‌های باقی‌مانده در پنجره فعلی و زمان ریست پنجره را نشان می‌دهند. هدرهای X-Quota سهمیه فراخوانی دوره، باقی‌مانده آن و زمان ریست را نشان می‌دهند. هر پاسخ همچنین X-Request-Id دارد: هنگام تماس با پشتیبانی آن را همراه با زمان درخواست به UTC، endpoint و وضعیت بفرستید. هرگز خود کلید را نفرستید.

گام بعدی

پرسش و پاسخ

Genesis API با APIهای رایگان صرافی‌ها چه تفاوتی دارد؟

APIهای صرافی‌ها دفتر سفارش‌ها و تیکرهای یک بازار را برمی‌گردانند. Genesis API اسپردهای محاسبه‌شده در ده‌ها صرافی و شبکه، پرچم‌های واریز و برداشت و داده‌های پاک‌شده از جفت‌های کم‌نقدینگی را برمی‌گرداند.

اگر از محدودیت فراتر بروم چه می‌شود؟

سرور با 429 و هدرهای X-RateLimit و Retry-After پاسخ می‌دهد. درخواست‌های اضافه هزینه‌ای ندارند.

آیا می‌توانم پلن API خود را عوض کنم؟

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

آیا می‌توانم از داده‌ها در محصول خودم استفاده کنم؟

بله، می‌توانید سرویس‌ها، ربات‌ها و داشبوردهای خودتان را روی Genesis API بسازید. حق فروش مجدد داده خام به همان شکل را ندارید.