API
API (رابط برنامهنویسی کاربردی) مجموعه قواعدی است که یک برنامه با آن از برنامهٔ دیگر داده یا عملیات میخواهد: کدام آدرس صدا زده شود، چه چیزی فرستاده شود و پاسخ در چه قالبی برمیگردد. معاملهگر وقتی به API نیاز پیدا میکند که قیمتها، دفتر سفارش و نرخهای فاندینگ را باید یک برنامه بخواند: ربات، جدول یا داشبورد.
نمونه درخواست
مثال فرضی: برنامهای از Genesis API پروفایل کوین IRYS را از بخش جستجوی کوین میخواهد، یعنی از طریق یک endpoint. درخواست یک HTTP GET است و کلید در هدر میرود:
curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
-H "X-API-Key: $GENESIS_API_KEY"
پاسخ به صورت JSON برمیگردد و بعضی فیلدها حذف شدهاند:
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true
}
}
}
انسان این اطلاعات را از صفحههای صرافی و بلاک اکسپلورر کنار هم میچیند؛ برنامه آن را در یک پاسخ میگیرد و بلافاصله حساب میکند که فیوچرز MEXC به اندازهٔ (0.0133 − 0.01329) / 0.01329 × 100 ≈ 0.075% بالاتر از اسپات معامله میشود.
API عمومی و خصوصی صرافی
API صرافی دو بخش دارد. بخش عمومی دادههای بازار (قیمتها، دفتر سفارش، معاملات) را بدون کلید میدهد. بخش خصوصی با حساب شما کار میکند (موجودی، سفارشها، تاریخچهٔ معاملات) و به کلید API و امضای درخواست نیاز دارد. در Binance endpointهای عمومی نوع امنیتی NONE دارند و بقیه کلید و پارامتر signature میخواهند.
داده به دو شکل میرسد. REST API به هر درخواست جداگانه پاسخ میدهد: با آن یک عکس لحظهای از داده را با فیلترهای دلخواه میگیرید. WebSocket اتصال را باز نگه میدارد و سرور خودش بهروزرسانی میفرستد: Binance معاملات و تغییرات دفتر سفارش را به همین شکل لحظهای پخش میکند.
API داده: چند بازار در یک پاسخ
API صرافی فقط بازار خودش را میشناسد. برای مقایسهٔ قیمت یک کوین در 20 صرافی برنامه به 20 اتصال نیاز دارد و هر صرافی قالب پاسخ و محدودیتهای خودش را دارد. API داده بازارها را از پیش یکجا جمع میکند.
| نوع API | چه برمیگرداند | دسترسی |
|---|---|---|
| API عمومی صرافی | قیمت، دفتر سفارش و معاملات یک صرافی | بدون کلید |
| API خصوصی صرافی | موجودی، سفارشها، برداشتها | کلید و امضا |
| Genesis API | اسپردها، دفتر سفارش، فاندینگ، DEX، آنچین، بازارهای پیشبینی | کلید، فقط خواندن |
یک درخواست به endpoint با مسیر /arbitrage/spot-spot در Genesis API اسپردهای محاسبهشده بین بازارهای اسپات بیش از 20 صرافی CEX را همراه با پرچمهای واریز و برداشت برمیگرداند. هر درخواست یک HTTP GET و هر پاسخ JSON است؛ پارامترها و فیلدهای هر endpoint در مستندات آمدهاند.
همچنین ببینید: API ارز دیجیتال: انواع و نحوهٔ انتخاب، شروع سریع در مستندات، rate limit، درس: API ارز دیجیتال چیست.
پرسش و پاسخ
برای کار با API به SDK نیاز دارم؟
اگر API با HTTP کار کند، هر کلاینت HTTP کافی است. برای Genesis API همان curl، کتابخانهٔ requests در Python یا fetch داخلی JavaScript بس است.
میشود از طریق Genesis API معامله کرد؟
نه. Genesis API فقط داده میدهد. سفارشها را خودتان روی صرافی ثبت میکنید، دستی یا با API خود صرافی و کلید آن، و مسئولیتش با شماست.