شروع سریع 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 داشته باشد کافی است.

API چه چیزهایی را پوشش میدهد
endpointها بخشهای سایت را بازتاب میدهند:
- آربیتراژ — اسپات - اسپات، اسپات - فیوچرز، فیوچرز - فیوچرز، DEX - اسپات، DEX - فیوچرز، کراسچین و آربیتراژ سهام.
- دفتر سفارشها — قیمت اجرا برای یک حجم در همه بازارها، «Order-book Δ» برای ردیفهای آربیتراژ، دفتر سفارشهای یک بازار، تاریخچه اجرا و اسلیپیج DEX (در پلنهای API Pro و Max).
- بازارهای پیشبینی — آربیتراژ پیشبینی و وضعیت پلتفرمها؛ تحلیل، پول هوشمند، معاملات بزرگ و جدول برترین تریدرها در پلنهای API Pro و Max.
- فاندینگ — نرخهای فاندینگ در همه صرافیها، اسپرد فاندینگ و تحلیل تاریخچه فاندینگ (در پلنهای API Pro و Max).
- بازار — Fair - Last، CEX پامپ و دامپ، DEX Dumps، ردیابی OI.
- آنچین — انتقالات بزرگ، جریانهای CEX، مینت و بریجها، کیفپولهای تیمها، پوزیشنهای Perp. DEX، آنلاکها، کلیمها، هکها؛ در پلنهای API Pro و Max همچنین نمای کلی DEX، تحلیل و صفحه کوین.
- هوش مصنوعی و جستجو — سیگنالهای Genesis AI+ و کارت کامل کوین.
- حساب — وضعیت کلید شما: پلن، سهمیه مصرفشده و محدودیتها.
مجموعههای داده در صفحه Genesis API توضیح داده شدهاند؛ پارامترها و فیلدهای هر endpoint در مستندات است.
پلنها و محدودیتها
API پلنهای مخصوص خود را دارد که از اشتراک سایت جداست: Trial، Start، Pro و Max. در سهمیه فراخوانی، محدودیت درخواست در ثانیه و تازگی داده با هم فرق دارند.
| پلن API | فراخوانی در ماه | تازگی داده |
|---|---|---|
| Trial | 500 هزار | 60 ثانیه |
| Start | 2 میلیون | 30 ثانیه |
| Pro | 5 میلیون | 10 ثانیه |
| Max | 10 میلیون | 5 ثانیه |
Trial ماهانه 20 $ هزینه دارد و Max اجازه 15 درخواست در ثانیه را میدهد. endpointهایی که جزو پلن شما نیستند خطای 403 با کد plan_restricted برمیگردانند. درخواستهای بیش از محدودیتها هزینهای ندارند: منتظر دوره جدید بمانید یا ارتقا دهید. فقط پاسخهای 200 از سهمیه مصرف میکنند: خطاها و پاسخهای 304 رایگاناند. قیمتها و مقایسه کامل در صفحه تعرفههای Genesis API است.
اولین درخواست شما
یک پلن انتخاب کنید
در صفحه تعرفههای Genesis API یک پلن و دوره انتخاب کنید و روی «خرید اشتراک» کلیک کنید. پرداخت با کریپتو است، درست مثل اشتراک سایت. اگر پلن API دیگری از قبل فعال باشد، پرداخت پلن جدید آن را جایگزین میکند و باقیمانده از دست میرود — سایت پیش از آن هشدار میدهد.
کلید خود را بگیرید
در پروفایل، در بخش Genesis API، روی «دریافت کلید» کلیک کنید. یک کلید
gns_live_…در پنجره «کلید API شما» ظاهر میشود — روی «کپی» کلیک کنید و ذخیرهاش کنید. فقط یک بار نمایش داده میشود.درخواست بفرستید
یک HTTP GET ساده بفرستید و کلید را در هدر
X-API-Keyبدهید. آدرس پایهhttps://api.genesisarbitrage.com/v1است. endpoint خوبی برای اولین بار/account/usageاست — پلن شما و سهمیه باقیمانده را نشان میدهد.پاسخ را تحلیل کنید
پاسخ موفق در یک پوشش واحد میآید: آرایه
dataو بلوکmeta. اگر مشکلی پیش آمد، جدول خطاهای زیر را ببینید.
یک نمونه curl:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
مستندات فرم «امتحان درخواست» دارد: کلید را بچسبانید، روی «ارسال درخواست» کلیک کنید و پاسخی خلاصهشده را همانجا در صفحه ببینید. کلید فقط در مرورگر شما ذخیره میشود.
قالب پاسخ
dataبسته به endpoint یک آرایه یا یک شیء است.metaتعداد آیتمها، زمان آخرین بهروزرسانی داده، تأخیر پلن شما بر حسب ثانیه و پلن شما را در خود دارد.- مقادیر خالی
nullهستند. زمانها بر حسب ثانیه یونیکساند. - اسپردها و نرخها درصد هستند: 0.92 یعنی 0.92%.
- همه پارامترهای فیلتر اختیاریاند: بدون آنها endpoint کل مجموعه داده را برمیگرداند.
خطاها و محدودیتها
| کد | معنا |
|---|---|
| 401 | کلید وجود ندارد، نامعتبر است یا لغو شده است |
| 403 | endpoint جزو پلن شما نیست |
| 404 | endpoint یا منبع پیدا نشد |
| 429 | از محدودیت نرخ فراتر رفتهاید — هدرهای X-RateLimit و Retry-After را ببینید |
| 500 | خطای داخلی، بعداً دوباره تلاش کنید |
| 503 | دادهها در حال بازسازی است، چند ثانیه بعد دوباره تلاش کنید — Retry-After را ببینید |
هدرهای X-RateLimit در هر پاسخ محدودیت درخواست در ثانیه، تعداد درخواستهای باقیمانده در پنجره فعلی و زمان ریست پنجره را نشان میدهند. هدرهای X-Quota سهمیه فراخوانی دوره، باقیمانده آن و زمان ریست را نشان میدهند. هر پاسخ همچنین X-Request-Id دارد: هنگام تماس با پشتیبانی آن را همراه با زمان درخواست به UTC، endpoint و وضعیت بفرستید. هرگز خود کلید را نفرستید.
گام بعدی
- کلید API: دریافت، نگهداری، صدور مجدد — کلید در پروفایل کجاست و چگونه از آن محافظت کنید.
- محدودیتها: سهمیه، درخواست در ثانیه، تازگی — چگونه از پاسخهای 429 دور بمانید.
- پاسخها و خطاها: JSON، ETag، کدهای HTTP — پوشش پاسخ، 304 و تلاش مجدد.
- endpointها به تفکیک گروه: آربیتراژ، دفتر سفارش، فاندینگ، بازار و سیگنالهای هوش مصنوعی، آنچین، بازارهای پیشبینی و آربیتراژ شرطبندی.
- Genesis API برای عاملهای هوش مصنوعی — مشخصات OpenAPI، llms.txt و function calling.
پرسش و پاسخ
Genesis API با APIهای رایگان صرافیها چه تفاوتی دارد؟
APIهای صرافیها دفتر سفارشها و تیکرهای یک بازار را برمیگردانند. Genesis API اسپردهای محاسبهشده در دهها صرافی و شبکه، پرچمهای واریز و برداشت و دادههای پاکشده از جفتهای کمنقدینگی را برمیگرداند.
اگر از محدودیت فراتر بروم چه میشود؟
سرور با 429 و هدرهای X-RateLimit و Retry-After پاسخ میدهد. درخواستهای اضافه هزینهای ندارند.
آیا میتوانم پلن API خود را عوض کنم؟
بله. پلن جدید بلافاصله پس از پرداخت اجرا میشود: محدودیتها و تازگی داده جدید فوراً اعمال میشوند، سهمیه فراخوانی از صفر شروع میشود و باقیمانده پلن قبلی از دست میرود. تمدید همان پلن به مدت فعلی روز اضافه میکند.
آیا میتوانم از دادهها در محصول خودم استفاده کنم؟
بله، میتوانید سرویسها، رباتها و داشبوردهای خودتان را روی Genesis API بسازید. حق فروش مجدد داده خام به همان شکل را ندارید.