BitMEX API Documentation

مستندات API بیت‌مکس: راهنمای جامع برای معامله‌گران مبتدی

مقدمه

بیت‌مکس (BitMEX) یکی از صرافی‌های پیشرو در زمینه معاملات فیوچرز و قراردادهای ابدی ارزهای دیجیتال است. این صرافی به دلیل اهرم‌های بالا، نقدینگی مناسب و ابزارهای پیشرفته معاملاتی شهرت دارد. یکی از مهم‌ترین ویژگی‌های بیت‌مکس، امکان دسترسی به API آن است. API یا رابط برنامه‌نویسی کاربردی، به شما اجازه می‌دهد به صورت خودکار و برنامه‌ریزی‌شده با صرافی تعامل داشته باشید. این امر برای معامله‌گران حرفه‌ای، توسعه‌دهندگان ربات‌های معامله‌گری (Trading Bots) و تحلیل‌گران بازار بسیار حائز اهمیت است. این مقاله به بررسی جامع مستندات API بیت‌مکس می‌پردازد و راهنمایی گام به گام برای مبتدیان ارائه می‌دهد.

چرا از API بیت‌مکس استفاده کنیم؟

استفاده از API بیت‌مکس مزایای متعددی دارد:

• سرعت و دقت: معاملات و درخواست‌ها به صورت آنی و بدون تاخیر انسانی انجام می‌شوند.
• اتوماسیون: امکان خودکارسازی استراتژی‌های معاملاتی و اجرای آن‌ها در زمان‌های مشخص.
• دسترسی به داده‌ها: دریافت داده‌های بازار به صورت زنده و تحلیل آن‌ها برای شناسایی فرصت‌های معاملاتی. تحلیل تکنیکال
• ادغام با سیستم‌های دیگر: اتصال API بیت‌مکس به سایر سیستم‌ها و نرم‌افزارهای معاملاتی.
• انعطاف‌پذیری: امکان سفارشی‌سازی و توسعه ابزارهای معاملاتی بر اساس نیازهای خاص.

پیش‌نیازها

قبل از شروع کار با API بیت‌مکس، باید پیش‌نیازهای زیر را داشته باشید:

• حساب کاربری بیت‌مکس: ایجاد یک حساب کاربری فعال در صرافی بیت‌مکس. ثبت نام در بیت‌مکس
• کلیدهای API: تولید کلیدهای API (API Key و API Secret) از طریق پنل کاربری. این کلیدها برای احراز هویت و دسترسی به API استفاده می‌شوند. مدیریت کلیدهای API
• دانش برنامه‌نویسی: آشنایی با یک زبان برنامه‌نویسی مانند پایتون، جاوااسکریپت یا سی++.
• درک مفاهیم API: آشنایی با مفاهیم پایه‌ای API مانند درخواست (Request)، پاسخ (Response)، متد (Method) و پارامتر (Parameter). مفاهیم API

ساختار مستندات API

مستندات API بیت‌مکس به خوبی سازماندهی شده و شامل بخش‌های مختلفی است:

• Authentication (احراز هویت): توضیح نحوه احراز هویت و استفاده از کلیدهای API.
• Endpoints (نقاط پایانی): لیست کاملی از نقاط پایانی API که هر کدام وظیفه خاصی دارند (مانند دریافت قیمت، ثبت سفارش، لغو سفارش).
• Data Structures (ساختارهای داده): توضیح ساختار داده‌های ارسالی و دریافتی از API.
• Error Codes (کدهای خطا): لیست کدهای خطا و توضیح نحوه رفع آن‌ها.
• Examples (مثال‌ها): مثال‌های کد در زبان‌های برنامه‌نویسی مختلف برای نشان دادن نحوه استفاده از API.
• Rate Limits (محدودیت نرخ): توضیح محدودیت‌های تعداد درخواست‌های مجاز در یک بازه زمانی مشخص.

احراز هویت (Authentication)

برای دسترسی به API بیت‌مکس، باید درخواست‌های خود را با استفاده از کلیدهای API احراز هویت کنید. این کار معمولاً با استفاده از هدر `X-API-Key` و امضای دیجیتال (signature) انجام می‌شود. امضای دیجیتال با استفاده از کلید `API Secret` و الگوریتم HMAC SHA256 تولید می‌شود.

مثال (پایتون):

```python import hashlib import hmac import requests

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

def authenticate(method, endpoint, request):

   timestamp = str(int(time.time()))
   message = timestamp + method + endpoint + request

   signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()

   headers = {
       'X-API-Key': api_key,
       'X-API-Signature': signature
   }
   return headers

```

نقاط پایانی (Endpoints)

بیت‌مکس API نقاط پایانی مختلفی را برای انجام عملیات گوناگون ارائه می‌دهد. در اینجا به برخی از مهم‌ترین نقاط پایانی اشاره می‌کنیم:

• /api/v1/ticker: دریافت قیمت لحظه‌ای جفت‌های معاملاتی. قیمت لحظه‌ای
• /api/v1/orderBookL2: دریافت دفترچه سفارشات (Order Book) سطح ۲. دفترچه سفارشات
• /api/v1/trade: دریافت تاریخچه معاملات. تاریخچه معاملات
• /api/v1/position: دریافت موقعیت‌های معاملاتی. مدیریت موقعیت
• /api/v1/order: ثبت، لغو و ویرایش سفارشات. ثبت سفارش
• /api/v1/account: دریافت اطلاعات حساب کاربری. اطلاعات حساب
• /api/v1/funding: دریافت اطلاعات مربوط به نرخ تامین مالی (Funding Rate). نرخ تامین مالی

ساختارهای داده (Data Structures)

API بیت‌مکس از فرمت JSON برای ارسال و دریافت داده‌ها استفاده می‌کند. درک ساختار داده‌های مختلف برای استفاده صحیح از API ضروری است. برای مثال، ساختار داده مربوط به یک سفارش (Order) شامل فیلدهایی مانند `symbol` (نماد جفت معاملاتی)، `side` (جهت سفارش - خرید یا فروش)، `orderType` (نوع سفارش - لیمیت، مارکت)، `quantity` (مقدار سفارش) و `price` (قیمت سفارش) است. انواع سفارشات

ساختار داده یک سفارش (Order)

**توضیحات** |

نماد جفت معاملاتی (مانند XBTUSD) |

جهت سفارش (Buy یا Sell) |

نوع سفارش (Limit, Market, Stop, etc.) |

مقدار سفارش |

قیمت سفارش (در صورت وجود) |

مدت زمان اعتبار سفارش |

محدودیت نرخ (Rate Limits)

بیت‌مکس برای جلوگیری از سوء استفاده و حفظ پایداری سیستم، محدودیت‌هایی را بر تعداد درخواست‌های مجاز در یک بازه زمانی مشخص اعمال می‌کند. این محدودیت‌ها به عنوان "محدودیت نرخ" (Rate Limits) شناخته می‌شوند. اگر از محدودیت نرخ تجاوز کنید، API با یک کد خطای مربوطه پاسخ خواهد داد. برای جلوگیری از این مشکل، باید درخواست‌های خود را بهینه کنید و از ارسال درخواست‌های غیرضروری خودداری کنید. بهینه‌سازی API

مثال عملی: دریافت قیمت لحظه‌ای

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

مثال (پایتون):

```python import requests import json

api_key = "YOUR_API_KEY" api_secret = "YOUR_API_SECRET"

url = "https://api.bitmex.com/api/v1/ticker" params = {"symbol": "XBTUSD"}

headers = authenticate("GET", "/api/v1/ticker", json.dumps(params))

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:

   data = response.json()
   print(data)

else:

   print(f"Error: {response.status_code} - {response.text}")

```

استراتژی‌های معاملاتی با API

API بیت‌مکس امکان پیاده‌سازی استراتژی‌های معاملاتی پیچیده را فراهم می‌کند. برخی از استراتژی‌های رایج عبارتند از:

• میانگین متحرک (Moving Average): استفاده از میانگین متحرک برای شناسایی روندها و نقاط ورود و خروج. استراتژی میانگین متحرک
• شاخص قدرت نسبی (RSI): استفاده از RSI برای شناسایی شرایط خرید بیش از حد (Overbought) و فروش بیش از حد (Oversold). استراتژی RSI
• باند بولینگر (Bollinger Bands): استفاده از باند بولینگر برای شناسایی نوسانات و نقاط شکست. استراتژی باند بولینگر
• آربیتراژ (Arbitrage): بهره‌برداری از اختلاف قیمت یک دارایی در صرافی‌های مختلف. استراتژی آربیتراژ
• معاملات بر اساس حجم (Volume-Based Trading): تحلیل حجم معاملات برای شناسایی فشار خرید و فروش. تحلیل حجم معاملات
• استراتژی‌های مبتنی بر یادگیری ماشین: استفاده از الگوریتم‌های یادگیری ماشین برای پیش‌بینی قیمت‌ها و اتخاذ تصمیمات معاملاتی. یادگیری ماشین در معاملات

تحلیل فنی و API

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

مدیریت ریسک

هنگام استفاده از API بیت‌مکس، مدیریت ریسک بسیار مهم است. باید محدودیت‌های ضرر (Stop-Loss) و سود (Take-Profit) را به دقت تنظیم کنید و از اهرم‌های بالا با احتیاط استفاده کنید. مدیریت ریسک در معاملات

نکات مهم

• همیشه قبل از استفاده از API در محیط واقعی، آن را در محیط تست (Testnet) آزمایش کنید.
• کلیدهای API خود را به صورت امن نگهداری کنید و از اشتراک‌گذاری آن‌ها با دیگران خودداری کنید.
• به محدودیت‌های نرخ API توجه کنید و درخواست‌های خود را بهینه کنید.
• به طور مداوم کد خود را بررسی و به‌روزرسانی کنید تا از عملکرد صحیح آن اطمینان حاصل کنید.
• از خطاهای API به درستی مدیریت کنید و در صورت بروز مشکل، اقدامات لازم را انجام دهید.
• همیشه از آخرین نسخه مستندات API استفاده کنید.

منابع بیشتر

• مستندات رسمی API بیت‌مکس: [۱](https://www.bitmex.com/app/api)
• انجمن توسعه‌دهندگان بیت‌مکس: [۲](https://www.bitmex.com/community/)
• آموزش‌های پایتون برای API بیت‌مکس: [۳](https://github.com/bitmex/api-connectors/tree/master/python)

تحلیل فاندامنتال معاملات الگوریتمی استراتژی‌های اسکالپینگ استراتژی‌های نوسان‌گیری استراتژی‌های بلندمدت استراتژی‌های مارتینگل استراتژی‌های ضد مارتینگل استراتژی‌های فیبوناچی استراتژی‌های الیوت ویو استراتژی‌های ایچیموکو استراتژی‌های شکست (Breakout) استراتژی‌های بازگشت (Reversal) استراتژی‌های روند (Trend Following) استراتژی‌های میانگین‌گیری (Mean Reversion) استراتژی‌های مبتنی بر اخبار

پلتفرم‌های معاملات آتی پیشنهادی

پلتفرم	ویژگی‌های آتی	ثبت‌نام
Binance Futures	اهرم تا ۱۲۵x، قراردادهای USDⓈ-M	همین حالا ثبت‌نام کنید
Bybit Futures	قراردادهای معکوس دائمی	شروع به معامله کنید
BingX Futures	معاملات کپی	به BingX بپیوندید
Bitget Futures	قراردادهای تضمین شده با USDT	حساب باز کنید
BitMEX	پلتفرم رمزارزها، اهرم تا ۱۰۰x	BitMEX

به جامعه ما بپیوندید

در کانال تلگرام @strategybin عضو شوید برای اطلاعات بیشتر. بهترین پلتفرم‌های سودآور – همین حالا ثبت‌نام کنید.

در جامعه ما شرکت کنید

در کانال تلگرام @cryptofuturestrading عضو شوید برای تحلیل، سیگنال‌های رایگان و موارد بیشتر!