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 صرافی: داده و دسترسی به حساب برای یک صرافی. صرافی قیمتها، دفترهای سفارش و معاملات را عمومی ارائه میدهد، اما موجودی، سفارشها و تاریخچه معاملات کلید و درخواست امضاشده میخواهند. Binance این را در قالب انواع امنیتی بیان میکند:
NONEبرای داده باز بازار،TRADEبرای ثبت و لغو سفارش،USER_DATAبرای جزئیات حساب (مستندات Binance). - API داده بازار: صرافیها و شبکههای متعدد در یک قالب. چیزهایی را ارائه میدهد که ترکیب چند صرافی لازم دارند: اسپرد بین صرافیها، نرخ فاندینگ نرمالشده به یک دوره، اوپن اینترست به تفکیک صرافی. Genesis API از همین نوع است و فقط داده میخواند.
- API آنچین (on-chain): داده بلاکچین مثل تراکنشها، انتقال توکنها و موجودی آدرسها. برچسبهایی مانند «صرافی»، «تیم پروژه» یا «نهنگ» از سرویسهای تحلیلی میآیند که روی دادههای شبکه ساخته شدهاند.
مقایسه شش نوع 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 مقایسه کنید.
برای بقیه دوره چه چیزی لازم دارید
- کلید Genesis API: در صفحه تعرفهها پلنی انتخاب کنید و کلید را با دکمه «دریافت کلید» در پروفایل بگیرید؛ مراحل در شروع سریع Genesis API است. کلید را در متغیر محیطی
GENESIS_API_KEYنگه دارید و هرگز در نشانی درخواست نگذارید. - curl برای نخستین درخواستها از ترمینال.
- Python 3.10+ و کتابخانه
requests(pip install requests) برای اسکریپتهای درسهای 2 و 4. - مستندات Genesis API: هر اندپوینت پارامترها، فیلدها، نمونه curl و فرم «امتحان درخواست» دارد که درخواست را مستقیم از صفحه میفرستد.
درسها روی هم بنا میشوند:
- درس 2: اولین درخواست شما، با نشانی، هدرها، کدهای وضعیت و JSON؛
- درس 3: کدام داده به کدام تصمیمها میخورد، از اسپرد و دفتر سفارش تا فاندینگ و جریانهای آنچین؛
- درس 4: پایشگر اسپرد و فاندینگ با Python؛
- درس 5: ریسکهای خودکارسازی، از جمله داده کهنه، خطاها، کلیدها و عاملهای هوش مصنوعی.
خودتان امتحان کنید
درخواستی بدون کلید بفرستید
در ترمینال
curl "https://api.genesisarbitrage.com/health"را اجرا کنید. پاسخ{"ok":true}یعنی درخواست رسیده و سرور با JSON جواب داده است.جدول را با فیلدها تطبیق دهید
جدول Spot – Spot و بخش Spot — Spot مستندات را باز کنید. فیلدهای صرافیها، قیمتها، اسپرد و وضعیت انتقال را پیدا کنید:
exchange_buy،price_sell،spread_pct،withdraw_enabled_buy.کارهای روتین خود را فهرست کنید
سه کاری را که هر روز انجام میدهید بردارید و هرکدام را با جدول بالا برچسب بزنید: سایت، Genesis API یا API صرافی.
اندپوینت یک کار را پیدا کنید
برای یکی از کارهای Genesis API، اندپوینت را در مستندات پیدا کنید و پارامترهای لازم را یادداشت کنید، مثل
coinوmin_spread. این درخواست را در درس 2 میفرستید.